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With VNC SDK you can connect VNC Viewers with VNC Servers. 
easily over the Internet. Using VNC Cloud, no complicated 
network configuration at either end is required! 


What will you create with VNC SDK? 
Check it out here: https://developer.realvnc.com/ 
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Getting connected: www.realvnc.com/products/vnc/raspberrypi/ 
For more information contact vncdeveloper@realvnc.com 


serial Pi Plus 


RS232 serial communication board. 
Control your Raspberry Pi over RS232 
or connect to external serial 
accessories. 


Breakout FP! Plus 


The Breakout Pi Plus is a useful 
and versatile prototyping expansion 
board for the Raspberry Pi 
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8 channel 18 bit analogue to digital 
converter. I?C address selection 
allows you to add up to 32 analogue 
inputs to your Raspberry Pi. 


IO Pi Plus 


32 digital 5V inputs or outputs. I?C 
address selection allows you to stack 
up to 4 IO Pi Plus boards on your 
Raspberry Pi giving you 128 digital 
inputs or outputs. 


RIC Pi Plus 


Real-time clock with battery backup 
and 5V I*C level converter for adding 
external 5V I?C devices to your 
Raspberry Pi. 
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1-Wire® to I?C host interface with ESD 
protection diode and I*C address 
selection. 


We also stock a wide range of expansion boards 
for the original Raspberry Pi models A and B 
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WELCOME TO 
THE OFFICIAL 
PI MAGAZINE! 


welve months have passed since The MagPi 
was relaunched as the official Raspberry 

Pi magazine. Our first issue was a bit of a 
double-whammy. It came at the time Raspberry Pi was 
celebrating its third birthday, as well as coinciding with 
the launch of the Raspberry Pi 2. 

Here we are exactly one year on and we’re celebrating 
another birthday and another incredible launch with 
the Raspberry Pi 3. Featuring built-in wireless LAN, 
Bluetooth, and a new processor clocked at 1.2GHz 
capable of 64-bit instructions, the Pi 3 is as a real 
game-changer for hackers and makers. You can skip 
ahead just a couple of pages to get the full low-down, 
including a detailed hardware breakdown, interviews 
with Raspberry Pi’s Eben Upton and James Adams, a 
full suite of benchmark tests, wireless how-to, and 
much more besides. 

Since we like to go the extra mile for our valued 
readers, we’ve also teamed up with ThePiHut.com on a 
fantastic offer for our print subscribers. On 29 February 
we sent all our print subscribers an email containing 
a unique code they could use at ThePiHut.com to be 
among the very first people in the world to receive 
Raspberry Pi’s latest credit card-sized PC. You can find 
all the details of the offer on pages 18-19 (and it’s not 
too late to take part if you’re not yet subscribed). 


Russell Barnes 
Managing Editor 
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RASPBERRY PI3 


The hottest Pi ever made has arrived. Here's everything you need to know about 
the new addition to the family, including benchmarks and project ideas 


YASMIN BEY 


This young enthusiast discovered 
the Pi and won an award for 
computing, all in the same year 


raspberrypi.org/magpi 


THE BIG FEATURE PI ZERO AVAILABILITY 


\We catch up with Raspberry Pi's 
Eben Upton to see what's at the 
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urprise! The Raspberry 
Pi 3 is here. The latest 
version of the credit 
card-sized computer comes a 
whole year after the launch of its 
predecessor, the Raspberry Pi 2, 
and has its own set of upgrades. 

Here’s the highlights: it’s faster, 
it has the exact same form-factor 
(so your cases still work), and yes, 
it has wireless on it. 

Through the course of this 
feature, we’re going to explore 
all the features of the Raspberry 
Pi 3 and even benchmark it in six 
different tests against its siblings. 

We have an interview with Eben 
Upton and James Adams about 
the creation of the Raspberry Pi 3, 
which also touches on the hurdles 
involved in adding wireless. 
Finally, we give you some great tips 
on how to use your Raspberry Pi 3 
and what to use it for. 

The Raspberry Pi 3 is available 
from anywhere that will sell you 
a Raspberry Pi right now, so grab 
one while reading the rest of 
the feature! 
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ANTENNA «~ 


There’s no need to connect an 
external antenna to the Raspberry 
Pi 3. Its radios are connected to 
this chip antenna soldered directly 
to the board, in order to keep the 
size of the device to a minimum. 
Despite its diminutive stature, 
this antenna should be more than 
capable of picking up wireless 
LAN and Bluetooth signals - even 
through walls. 
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WIRELESS RADIO « 


So small, its markings can only be 
properly seen through a microscope 
or magnifying glass, the Broadcom 
BCM43438 chip provides wireless 
LAN, Bluetooth, and Bluetooth 
Classic radio support. Cleverly built 
directly onto the board to keep 
costs down, rather than the more 
common fully qualified module 
approach, its only unused feature is 
a disconnected FM radio receiver. 


7 
SOC ¢ 
Built specifically for the new 
Pi 3, the Broadcom BCM2837 
system-on-chip (SoC) includes 
four high-performance ARM 
Cortex-A53 processing cores 
running at 1.2GHz with 32kB 
Level 1 and 512kB Level 2 cache 
memory, a VideoCore IV graphics 
processor, and is linked to a1GB 
LPDDR2 memory module on the 
rear of the board. 
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Broadcom BCM2837 
4x ARM Cortex-A53, 1.2GHz 

Broadcom VideoCore IV 

1GB LPDDR2 

10/100 Ethernet, 2.4GHz 802.11n wireless 
Bluetooth 4 Classic, Bluetooth Low Energy 
microSD 
40-pin header, populated 


HDMI, 3.5mm analogue audio-video jack, 4x USB 
2.0, Ethernet, Camera Serial Interface (CSI), Display Serial 
Interface (DSI) 
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GPIO ® 


The Raspberry Pi 3 features the 
Same 40-pin general-purpose 
input-output (GPIO) header as all 
the Pis going back to the Model 

B+ and Model A+. Any existing 
GPIO hardware will work without 
modification; the only change is a 
switch to which UART is exposed on 
the GPIO’s pins, but that’s handled 
internally by the operating system. 


feature 


\ 
USB CHIP * 
The Raspberry Pi 3 shares the 
same SMSC LAN9Q514 chip as 
its predecessor, the Raspberry 
Pi 2, adding 10/100 Ethernet 
connectivity and four USB 
channels to the board. As before, 
the SMSC chip connects to the 
SoC via a single USB channel, 
acting as a USB-to-Ethernet 
adaptor and USB hub. 
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The tiny BCM43438 
chip provides built-in 
wireless and Bluetooth 


feature | RASPBERRY: 


t’s been four years 
since the launch of the 
original Raspberry Pi, 

and project co-founder Eben 
Upton has but one word to 
describe that period: “Packed!” 

he laughs from his home in a 
small Cambridgeshire village. 
“Just sort of non-stop.” 

“There’s just this sense of 
not really having stopped,” he 
tells us on behalf of the growing 
Raspberry Pi team. “Of just having 
worked continuously.” 

The culmination of the team’s 
ambitions, the Raspberry Pi 3 
excites Eben for one main reason: 
“Connectivity. The other stuff is 
just quantitative change, it’s just 
faster, more,” he explains. “The 


10 | MdgPi March 2016 


wireless and Bluetooth is the big 
step change on this device. It’s 
something people have asked us 
for for a long time. It’s been this 
missing element of the platform. 

“Tt wasn’t on the original device 
because it was a million miles 
beyond us at the kind of scale we 
were at back then,” Eben admits, 
thinking back to the early days of 
the Foundation. “We sold 800,000 
Raspberry Pis before we hired our 
first employee. There’s no way you 
could do this sort of stuff with no 
employees. It’s eaten a couple of 
man-years, probably, getting radio 
onto the device.” 


TESTING 


Conformance testing, too, would 
have been difficult. “You can do 
all the testing for an unintentional 
radiator in a couple of days. Pete 
[Lomas] and I did the original 
one; Pete, James [Adams], Gordon 
[Hollingworth], and I did the 
subsequent products,” Eben 
recalls. “The radio stuff, you give 
it to a guy and he takes six weeks 
and just rams through all of these 
tests. The test campaign for Pi3 
has cost us, basically, £100,000,” 
some ten times that of its radio- 
free predecessors. 

The radio chip isn’t the only 
new feature, of course. The new 
BCM2837 system-on-chip has 
been developed specifically for the 


project by Broadcom. “It’s kind of 
a mixture of being able to make a 
business case for it, and then all 
those people at Broadcom who 
believed in the mission and were 
prepared to do the work to get it 
over the line,” Eben explains of 
how the Foundation was able to 
convince the multinational chip 
giant to build custom chips for the 
project. “That’s people from fresh 
graduate engineers all the way up 
to people in the C-suite at the top. 
Tricky, though!” 


USB AND PXE 
NETWORK BOOT 


Even with the chip designed and 
taped out in March of last year, the 
Foundation had some final input 
for Broadcom in order to add two 
new features: direct USB mass- 
storage and PXE network boot 
capabilities. “Gordon rewrote the 
boot ROM for the chip and then 
provided an updated boot ROM to 
Broadcom, saying ‘shove this in 
the chip, it’1] work’,” Eben laughs. 
“And it does! 

“The other interesting thing 
about the chip is for all other ones 
the implementation work was done 
entirely in Cambridge; this one was a 
collaboration with Broadcom’s set- 
top box engineering group in Aztec 
West [business park] in Bristol.” 

Eben readily admits that not all 
the capabilities of the new parts 
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with minimal change and that would also be affordable. 


Secondly was how to connect it to the 2837 processor. 

And Eben managed to secure a good solution from 

" Broadcom, the BCM43438, and | then set about 
squeezing it onto the Pi. The layout for the BCM43438 was 
a real challenge -— as, for radio, layout really matters. 
Connectivity-wise, 2837 actually has two SD card 
controllers and two UARTs. We decided to look at 
swapping to the Broadcom SD card controller as the 
main [onel, and using the standard SD controller to talk to 
the wireless. For Bluetooth, we use the existing UART and 
swap the UART on the GPIO pins to the second UART. 


ahi really compelling advantages to 
still being basically ARMv6, and 
because it’s [Cortex-]A53 it’s a 


really good 32-bit processor.” You need to have a completed schematic and then 
are going to be used at launch, Aware of the high demand iterate on the layout: place parts and shuffle them around 
however. “Although it is a 64-bit that a Raspberry Pi launch until you can see roughly how the connections will work 
core, we’re using it asjusta faster typically encounters, talk turns to out before committing to routing the tracks out. It really 
32-bit core,” he reveals about production. “We’ve already made is part art and part science, and takes a bit of practice 
the Pi 3’s central processing unit. 30,000 of it,” Eben discloses, still before you get a good feel for how to do it well | also like 
“T can imagine there’d be some some weeks ahead of the release. to make sure all my designs look good, too, but that bit's 
real benefits [to 64-bit code]. “T’d like to do at least three million not strictly necessary: 
The downside is that you do units, and that requires you to 
really create a separate world. To build, say, 60,000 a week. We’ll 
access that benefit, you’d have to probably build around 100,000 Roger Thornton for managing most of the test-script 
have two operating systems. I’m a week in the UK, plus whatever writing and conformance paperwork as well as plenty 
hoping that someone will come Embest builds in China, fora of work on the RF side, closely followed by Phil Elwell 
and demonstrate to me that this month or two, then you back off to for sterling work on the Bluetooth and wireless stack, 
is a good idea. But there are some maybe 60,000 a week.” and Kalevi Ratschunas and the team at Broadcom for 


their hard work on the firmware side. I'd also like to thank 
Alistair May, who gave us some invaluable help and 
advice when we were initially getting to grips with the RF 
engineering challenges. 


Raspberry Pj 3 
896-8660 Ay = /) That's an easy one: I'd like to see USB 3.0 added, as it 


Raspberry Pi 3 Mode! 8 
Made in United <2 really is the universal solution for adding peripherals 
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hat’s the point of the 

launch of a new piece 

of technology without 
some form of performance 
benchmark? None, we say, and 
as the Raspberry Pi 3 promises 
to be that much more powerful 
than its predecessors, we 
thought we’d put it through the 
full range of tests to see how it 
compares to the Model B+, A+, 
Zero, and Raspberry Pi 2. 

As well as the usual rounds of 
different tests on how powerful 
the processor is, we’re testing 
the frame rate in Quake III, and 
even looking at power draw. 
The last one is important for 
many makers, and we’d be 
remiss not to include it. 

Like any test of this nature, 
this all involves perfect 
conditions and pure number 
performance, so it won’t 
always translate to real-world 
performance. It’s definitely a 
good guide, though. 
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» Raspberry Pi 3 


» 2.4GHz 
802.11b/g/n 
wireless network 


» Your network 
name (SSID) 


» Your network 
key (PSK) 


March 2016 


The network icon provides 
easy access to nearby 
wireless networks 


Just click on your network's 
name and, if required, enter 
the key 


The shield icon indicates an 
encrypted network which 
requires a key 


Cancel 


up blue as it tries to connect. If the 
connection is successful, it will 
stabilise and display the current 
signal strength; if not, make sure 
you chose the right network name 
and entered the correct key. 


CONNECTING FROM 
THE COMMAND LINE 


If you are using the Lite version 

of Raspbian, without the desktop, 
you'll need to configure your wireless 
network at the command line 
instead. At the console, type the 
following command: 


sudo nano /etc/wpa_ 
supplicant/wpa_Ssupplicant. 
conf 


Scroll to the bottom of the file, 
and enter a network definition 
using the following template: 


network={ 
SSid=”NetworkName” 
psk=”NetworkKey” 
key_mgmt=WPA-PSK 


...where NetworkName is your 
network’s SSID and NetworkKey 
is the encryption key. If 
connecting to a WEP rather 

than WPA/WPA2 network, put 
key_mgmt=NONE. If connecting to 
an open network, you only need 
the SSID. 

Save the file with CTRL+O, 
then exit with CTRL+X. In a few 
seconds, your Pi should connect 
to the network. You can test this 
with the following command: 


ifconfig wlan@g@ 
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The best way to use your new Raspberry Pi 3 
is with a fresh Raspbian or NOOBS installation. 
To use an existing Raspbian microSD card with 
the Pi 3, you'll need to make a modification. 

In your older Pi, boot Raspbian and opena 
terminal. Type the following command: 


sudo apt-get update 
sudo apt-get dist-upgrade 


Shut the Pi down: 
sudo shutdown -h now 


Transfer your microSD card to your Pi 3 
and your existing operating system will boot. 
Finally, make sure you're up to date: 


sudo apt-get update 
sudo apt-get upgrade 


Available exclusively on the Raspberry Pi 2 
and 3 thanks to their increased RAM, OpenGL 
3D acceleration support is currently in the 
experimental stage. You can enable the new 
driver with the following command: 


sudo apt-get update && sudo apt-get 
install xcompmgr 1ibgl1-mesa-dri 


Be warned, though: with the OpenGL driver 
installed, you'll no longer be able to swap your 
microSD card between the Pi 2 or Pi 3 and 
any other model, as it will fail to boot on any 
Raspberry Pi with less than 1GB of RAM. 


The BCM43438 has a single-band wireless 
radio. You need to be running a 2.4GHz- 
only or dual-band 2.4/5GHz network to 
successfully connect. 


If you're writing new software for the 
Raspberry Pi, or porting existing software 


across, there are a few tricks that will help 
you get the most out of the Raspberry Pi 3... 


Where you can, make your software 
multi-threaded. The Pi 2 and Pi 3 both 
feature quad-core processors, and a fully 
threaded application will run up to four 
times faster than one which runs in a single 
thread. In scenarios where true multi- 
threading isn't possible, look at spawning 
multiple copies of your program and 
splitting the workload between them. 


ARM's NEON single- 
instruction multiple-data (SIMD) extensions 
are fully supported on the BCM2836 and 
BCM2837 chips used in the Pi 2 and 3, 
and using them offers an impressive 
speed boost: switching from the standard 
Linpack benchmark on the Pi 3 to a version 
compiled with NEON support boosts its 
score from 193MFLOPs to 459MFLOPs. 
NEON applications, however, won't run on 
the BCM2835 used on the B+, A+, and Zero. 


At present, the 
64-bit Cortex-A53 cores on the Raspberry 
Pi 3 are used exclusively in 32-bit mode. 

If you're looking to port a new operating 
system to the Pi 3, consider doing so as a 
native 64-bit version; if you can prove that 
doing so offers a performance advantage, 
we may see an official 64-bit Raspbian 
build released in the future. 


At the time of writing, the driver for Bluetooth 
Classic and Bluetooth Low Energy modes has 
not yet been finalised. By the time you read 
this, however, you should be able to install 
the modules after the aforementioned 
apt-get dist-upgrade using: 


sudo apt-get install pi-bluetooth 
For more information on how to use 


Bluetooth on Pi 3, please read the launch 
blog post at raspberrypi.org. 
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he launch of the 

shiny new Raspberry 

Pi 3 brings with it 
an exciting combination of 
improved performance and new 
functionality, but all the features 


in the world aren’t much use if 
you don’t have any ideas. Here 
are our suggestions for five new 
uses for the Pi3, made possible 
by improvements made by the 
Raspberry Pi Foundation. 
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The Broadcom BCM43438 radio 
chip is high-performance yet 
low-power, making it perfect 
for building your own sensor 
networks. Connect everything 
from temperature sensors to 
cameras to your Raspberry Pi 3 
and have it communicate its 
findings via wireless LAN for quick 
and easy Internet of Things (loT) 
goodness, or drop the power draw 
further and build a Bluetooth Low 
Energy network with multiple Pi 3 
systems. For remote installations, 
try pairing to a cheap second- 
hand GSM mobile handset via 
Bluetooth Classic. 


As well as wireless 802.11n 
and Bluetooth Low Energy, 

the BCM43438 chip supports 
Bluetooth Classic mode, 
including the Advanced Audio 
Distribution Profile (A2DP). 
Support for A2DP means it’s 
possible to configure a Pi 3 as 

a streamer, either receiving 
audio from a device such as 

a smartphone or tablet for 
amplification via HDMI or 
analogue outputs, or sending 

its own audio to a remote A2DP 
destination such as a Bluetooth- 
enabled soundbar or hi-fi system. 
You can even build on existing 


Pi-powered Bluetooth projects 
without having to buy a 
USB radio dongle. 
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The Raspberry Pi has always 


had a powerful graphics 
processor, and now that the 
central processor can keep up, 
we're going to see increasingly 
complex games being built on 
the system. For those who enjoy 
the classics, the Pi 3's increased 
performance means smoother 
emulation in general, plus 
support for emulating newer or 
more demanding systems and 
titles. For others, there's promise 
that future Pi games will be 

able to give mainstream titles 

a real run for their money in the 
graphics department. 


We've seen the Raspberry Pi 
used to build a pseudo thin- 
client infrastructure in the past, 
but the need for local storage 
in the form of the microSD card 
has kept it from being a truly thin 
implementation. The promised 
support for PXE network boot 
means that a Pi 3, unlike any 
other model, can be used as a 
thin client without the need for 
any local storage, decreasing 
deployment cost and increasing 
reliability - and no more risk 
of anyone walking off with the 
SD card! 


The BCM2837 at the heart of 
the Pi 3 uses the 64-bit ARMv8 
microarchitecture, compared 

to the 32-bit ARMv7 and ARMv6 
of previous models. As well 

as widening compatibility for 
running other operating systems, 
the shift to 64-bit holds the 
potential to improve performance 
- but it’s going to be up to the 
community to demonstrate 

that splitting Raspbian into 

32-bit and 64-bit variants offers 
advantages enough to outweigh 
the headache of maintaining and 
supporting two distinct operating 
system builds. 
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FIND YOUR EMAIL FROM THE MAGPI 
The email was sent to all 
subscribers on 29 February from 


magpi@raspberrypi.org 


GRAB YOUR SUBSCRIBER CODE 
Make a note of your unique code 
or copy it from the email 


VISIT THEPIHUT.COM 
Visit thepithut.com 
and put a Pi 3 in your basket 


® 
v = | U T ENTER YOUR UNIQUE SUBSCRIBER CODE 
= Simply paste or write-in your code 
www.ThePiHut.com at the checkout 


Use your subscriber 
code at The Pi Hut to: 


@® Jump to the front 
of the queue 


@® Get priority handling 
of your Pi 3 order 


If you're an existing subscriber and you didn't receive an email, it 
might be because your address isn't in the subscriptions database. 
To rectify this simply email magpi@selectps.com with your full 
name and postcode and our subscriptions team will reply with your 


: ; ; unique code within 24 hours. 
@ Be fir st in line Not a subscriber? It's not too late to make use of this offer. 
if stock 1S SJalela Simply subscribe (over the page) and email magpi@selectps.com 
requesting your unique subscriber code before 13 March to make 
use of this fantastic offer. 
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GET YOUR CODE 
IN SPACE! 


SWITCH ON! 


Ed and Izzy are finally up and running on the International Space Station: 
what have the Astro Pis been up to so far? 


hile the two Astro Pis 
were launched in early 
December last year, they 
have until recently been sitting 
aboard the International Space 
Station, waiting to be turned 
on. It wasn’t until January 
that the first Astro Pi was 
even unpacked. 
Due to the astronauts’ busy, 
tightly organised schedules and all 
the precautions and regulations 


Astro Pi launch 

6 December 2015 

The two Astro Pis are launched 
into space from Cape Canaveral in 
Florida, on a course for the ISS. 
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aboard the ISS, even the switching 
on of the computers was planned 
as part of the schedule. After some 
minor delays requiring Tim to 
perform a spacewalk, Ed was booted 
up on 2 February 2016 and began 
his first experiment. 

There was excitement online 
and at the Raspberry Pi offices 
as the Astro Pi was finally turned 
on; a Twitter conversation taking 
place between Tim and the 


On the ISS 
9 December 2015 
After a few days in space, the Astro 


Pis finally arrive at the ISS, where 
they wait to be unpacked. 


freshly woken Ed confirmed that 
switch-on was successful. 

The Crew Detector code was settled 
on as the first long-term experiment. 
This program was created by 
Cranemere Code Club from Cranmere 
Primary School and ran for a whole 
week, measuring humidity in the 
capsule to try to detect whether or 
not one of the crew members had 
entered the European Columbus 
module where it was currently 


‘’ 
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Tim goes to space 

15 December 2015 

Astronaut Tim Peake blasts off into 
space with his team, ready to start his 
mission aboard the ISS. 
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Want to keep up with the adventures of Ed and Izzy in a more colourful 
format? Their tale is being told through several parts in the cartoon series, 
The Story of Astro Pi. Part one is already up and ready for everyone to watch 
on the Astro Pi website; you can watch it here: magpi.cc /12PCaxJ4 


situated. If a pre-specified change in 
humidity was detected, it would ask 
for any crew around to confirm they 
were in the capsule. 

Ed will be running several other 
experiments during Tim’s mission 
on board the ISS. Immediately after 
Crew Detector finished, Ed started 
running SpaceCRAFT, a Minecraft- 
themed experiment. 

To get a glimpse into how busy 
the astronauts are on board, 
prompting this delayed switch-on, 
you only need to look at the weekly 
blogs revealing Tim’s exploits on 
the ISS. For the week of the Astro Pi 
switch-on, he’d removed a shutter 
door on the ESA’s Biolab, replacing 
it with a cover that allowed the 
unit to begin more experiments. 
He filled out questionnaires on his 
‘space headaches’ and did testing 
on his skin; remember, along with 
other experiments, each astronaut 
is themself an experiment on 
how well humans can survive 
living in space. 


Unpacking the Astro Pis 
4 January 2016 

Ed is set up in the ISS at his 
designated spot, ready and 
waiting to be turned on. 
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Before switching on the Astro 
Pi, Tim worked on the airlock 
in the Kibo laboratory. He then 
followed up the switch-on by 
talking to UK schoolkids and 
attending his weekly medical. The 
list goes on, with more work in 
Kibo throughout the week, loading 
up the Cygnus cargo craft before 
it leaves, and helping his fellow 
crewmates with a spacewalk. 

It’s a busy life for an astronaut, 
and, as everything in space is said 
to take three times longer than 
normal, it can’t all be done as 
quickly. So, after a very busy two 
weeks on board the ISS, it was 
finally time for Izzy to be turned on. 

Izzy had been waiting for the 
Cygnus space capsule to leave 
the ISS, as it was blocking the 
porthole that she would be 
using to look down on the Earth 
for her experiments. With the 
capsule’s departure, she was 
finally unpacked and booted up 
on 16 February 2016. To begin with 


Ed boots up 

2 February 2016 

Ed gets switched on by Tim Peake 
and starts running Crew Detector 
as his first experiment. 
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she’ll be running Flags, code from 
Space-Byrds of Thirsk School that 
shows the flag of the country the 
ISS is currently flying over. 

So, after over a year of planning 
and coding, the Astro Pis are 
both finally operational, running 
schoolkids’ code on Raspberry 
Pis orbiting the Earth. Hopefully, 
we’ll start getting data soon so 
we can see just what results the 
programs are producing. 


Izzy switches on 

216 February 2016 

Finally, Izzy is activated by Tim and 
begins her experiments, pointing her 
camera at the Earth far below. 
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News 


WHAT ARE ED 
AND IZZY UP TO? 


Each Astro Pi has a separate mission. What are they? 
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Performing experiments with the crew and on the 
@ environment of the ISS. Follow Ed on Twitter @astro_pi_vis 


Experiment: SpaceCRAFT 
Coder: Hannah Belshaw, 
Cumnor House Girls’ School 


Taking data from the Astro Pi's 
sensors, Hannah's code visualises the 
information in Minecraft. Columns of 
specific blocks represent different 
environmental measurements, and 

a blocky model of the ISS is used to 
represent movement and orientation. 


Experiment: Reaction Games 
Coder: Team Terminal, 
Lincoln UTC 


A suite of reaction games with a little 
Sense HAT-optimised interface that 
records astronauts’ response times 
over a set period, to investigate 

how reaction times change during 
prolonged space flight. 


Experiment: Radiation 
Coder: Arthur, Alexander, and Kiran, 
Magdalen College School 


Avery clever use of the camera module, 
this code detects space radiation over a 
period of time, to measure the intensity 
and level of radiation. It does this by first 
having the camera lens blanked off to 
prevent normal visible light from being 
recorded. However, this doesn't stop 
high-energy radiation being detected; 
this will cause specks of light, which are 
then recorded. 


IZZY THE 


@ 


Mo ASTRO PIIR 


Staring out at the planet she came from, Izzy will be taking 
pictures of Earth. Follow her on Twitter @astro_pi_ir 


Lal OxC 
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Izzy is equipped with 

a Pi NolIR Camera 
Module, allowing her to 
see infrared light. This 
makes her uniquely 
suited to run the Trees 
code by the Enviro Pi 
team of Westminster 
School. Pictures will 
be taken of the ground using the IR camera as Izzy 
orbits the Earth, staring out of the ISS's window. 
Using a special ‘false colour’ image processing 
technique, a Normalised Differentiated Vegetation 
Index (NVDI) can be ascertained which measures 
the health of plants. This processing occurs on the 
ground after the pictures have been taken. 


NEW CODING 
COMPETITION! 


While the two Astro Pis already contain code from 
several schoolchildren, there's now a chance for others 


to send up more code to run on Ed and Izzy! 


If you want to get involved, there are two challenges 
you can take part in. The first is to create an MP3 music 
player in Python to run on one of the Astro Pis. The 
second challenge is to actually create some music to 
play on the music player using Sonic Pi. 

You can find out more information on how to enter on 
the Astro Pi website: magpi.cc/AstroPiChallenge. 

You'll need to hurry, though: entries must be received 
by 31 March 2016! 
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The files allow you 
to print an almost 
exact replica of the 
Astro Pi case 

on the ISS 


The port for 

the Sense HAT 
LED matrix and 
joystick are usable 
in the build 


You can even 

fit in the same 
push buttons 

used in space, 
although they area 
little pricey 


You can have it bent ‘Ss Find out how to make your own 
rinted in an ; 
r olour: ahd ae by following these instructions! 


sand it down for magpi.cc/1KbS617 
smoothness 


) { \ ] | | Want to make an Astro Pi at home? Now you finally, 
A K E () R properly can, thanks to the official 3D-printable Astro Pi 
flight case! While it may not be milled out of aluminium 
or weigh as much as the original, it functions in exactly 
the same way as the version in space. It lets you view the 
LED matrix on the Sense HAT, use the joystick, and even 


Perform experiments that are out-of-this-world add some buttons. For people taking part in the new 


Coding Challenge, it’s also a good way to test out your 


witha 3D-printed Astro Pi case and a Sense HAT code ona unit like the one Tim has up on the ISS. 


HERE'S SOME 


EXPERIMENT WITH 


; Y 
People were quick to start creating their own THE SENSE HAT! 
Astro Pis. Here are some of our favourites You've got your Astro Pi: so what do you do now? 


Experiment! The Sense HAT was designed to sense its 


Alan McCullagh’s mini Astro Pi case is no larger environment, which allows it to perform many types of 


than a Raspberry Pi Zero. If only there was a 


repays [Ene pase experiments. If you're not sure where to start, why not 


have a look at our new book, Experiment with the Sense 
Q Alan McCullagh {i 2 Follow HAT! We tell you how to get started with this neat Pi 
add-on and how to use every function, before 

giving you several cool projects 

to try out that make full use 


of the Sense HAT. magri 


Have printed off "mini" flightcase to 
see what it's like=o) 


The book is available EXPERIMENT 
digitally vi f WITH 
igitally via our app for TH SENSE, 


only £2.99, or you can 


get the brand new print H Al 


version for £3.99! 
Check out our website CAR 


SENSE THE REAL WORLD 


Recreating Tim Peake's famous (in 
the Pi community) pose, the young 
space cadet and occasional MagPi 
writer Jasper Hayler-Goodall holds 
his silver version proudly 


for more details: nr 
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News 


Below Production 
scaling has proven 
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a challenge for 
the Raspberry Pi 
Foundation’s first 
in-house board, 
the Pi Zero 


RASPBERRY PI ZERO 


RASPBERRY PI 
ZERO PRODUCTION 
GETTING ON TRACK 


First-party hardware production leads to scaling challenges 


he launch of the Raspberry 
Pi Zero, the world’s 

first fully functional 
microcomputer to cost just £4/S5, 
caused quite a stir. Unsurprisingly, 
given the precedent of the 
Foundation’s other launches, initial 
stock sold out within minutes. 
What has been more surprising is 
that stock continues to be elusive, 
with small batches appearing in 
the official sales channel only to 
immediately disappear again under 
a flood of demand. 

The scarcity of the Pi Zero has 
led to a ‘black market’ of sorts 
appearing. When we gave away a 
cover-mounted Zero with issue 40, 
we were disappointed to see auction 
sites filled with opportunists trying 
to profit from purchases from 
Supermarket shelves. 

Even now, there are unscrupulous 
outlets looking to profit from the 
high demand for the device. Some 
retailers have taken to buying up 
stock from the official outlets in 
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order to resell at a substantial 
mark-up; one seller was recently 
found to be adding a pair of cheap 
adaptor cables to the Pi Zero in 
order to attempt to justify a £36 
selling price. 

Buyers are disappointed 
that they can’t easily get their 
hands on one or more Pi Zeros 
for their planned projects, and 
doubly so when they see rampant 


Foundation co-founder Eben Upton 
explained during an interview in 
early February. “It’d be good to get 
to a point where we’ re doing at least 
50,000 a month for Zero. I think we 
could do 50,000 a month on Zero 
pretty comfortably.” 

But, given the tradition for new 
Pi models to sell out at launch, 
why is it taking so long to ramp 
up production on the Zero? The 


Theres light at the end of the 
tunnel: production 1s being 
ramped up to meet demand 


profiteering. Fortunately, there’s 
light at the end of the tunnel: 
production is being ramped up to 
meet demand. 

“T placed another 150,000 POs 
[production orders] — well, a pair 
of POs, a50K and a100K — in the 
last couple of days,” Raspberry Pi 


answer lies in the board’s unique 
position, Eben reveals. “This isn’t 
quite the same as the other Pis, 
because the other Pis are made by 
RS and Farnell. We make these Pis, 
so you’re actually looking at a small 
company trying to scale.” 

“We’ve got good resources and 
good engineers, but you’re looking 
at a small company trying to scale 
production,” Eben continues. “It’s 
not quite realistic to compare the [Pi 
Zero] throughput to the throughput 
of the big Pis, because the big Pis 
are being made by billion-dollar, 
billion-pound companies; the Zero’s 
being made by us.” 

The launch of the Pi 3 won’t see 
the Zero put on the back-burner, 
though. “If we can get it stable at 
50,000 a month,” Eben promises, 
“then we can look at how we can 
scale up from that.” 
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Code Club is a nationwide network of volunteer-led after school clubs 
for children aged 9-11. 


We're always looking for people with coding skills to volunteer to run 
a club at their local primary school, library or community centre for an 
hour a week. 


You can team up with colleagues, a teacher will be there to support 
you and we provide all the materials you ll need to help get children 
excited about digital making. 


There are loads of ways to get involved! 


So to find out more, join us at www.codeclub.org.uk 


RIDES A WHALE 


The award-winning Raspiwhale project features a Pi- powered tracking device 
attached to a whale. We chat to its designer, Daniel Perez Martinez 


Since the Raspiwhale is designed to be attached 


to a marine mammal, it features a waterproof case 
to protect the electronic components inside. As an 
extra precaution, the Raspberry Pi Model At itself 
has its connections sealed with a special resin. 
Two 3200mAh Li-Po batteries power the Pi and an 
XBee radio transmitter. The watertight container 

is attached to a base with three suction cups for 
mounting on the whale's back. At the end of a 
session, the suction cups are vented to release the 
device, which floats to the surface to be recovered 
by the team. 


re there any places left to 
~ which the Raspberry Pi is 

yet to venture? Even the sky 
is no limit, with two Astro Pis having 
rocketed to the International Space 
Station. Back on planet Earth, the Pi 
is exploring new depths as it dives 
towards the seabed of the South 
Atlantic... mounted on the back of 
a whale! 

As well as being one of the 
most extraordinary Pi projects 
we’ve encountered, Raspiwhale 
(magpi.cc/1010zSs) has a serious 
scientific purpose: to research 
the behaviour of southern right 
whales (Eubaleana australis) 
around Peninsula Valdés, 

Puerto Madryn, Argentina. 

The Raspberry Pi is a recent 
addition to this long-running 
research project. “Around ten years 
ago, | was the leader of the research 
team to explore reactions of whales 
to vessels at harbours and bays,” 
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explains Raspiwhale creator Daniel 
Pérez Martinez. “I needed a device 
that would allow me to measure the 
behaviour of the whale, and knew that 
they were developing instruments 

of this kind in the United States. 

The problem was that they were in 
the experimental stage or were very 
expensive - over $20,000.” This led 
the team to think about creating their 
own devices. Since the Raspberry Pi 
hadn’t yet been launched, the first 
attempt involved a Gumstix board, 
without success; this was followed by 
the use of simple data loggers. 

When the research project was 
continued as a doctoral thesis of 
Belen Arguelles — at the laboratory 
of applied ecophysiology of 
CENPAT-CONICET directed by Dr 
Marcelo Bertellotti — Daniel offered 
to develop a new device. “Exactly a 
year ago I discovered the Raspberry 
Pi world,” he tells us, “and I turned 
fully to developing ideas. Of course, 
Raspiwhale was the priority.” 


A watertight solution 
The Raspiwhale 1 (RW1) unit 
comprises two main parts: a base 
equipped with suction cups to stick 
to a whale, with a float to enable 
subsequent recovery from the sea, 
and a watertight container to house 
all the electronic components. The 
latter includes a Raspberry Pi Model 
A+, two LiPo batteries, sensors, 
XBee transmitter, hydrophone, 
and HD camera. 

The RW1 took Daniel six 
months to research and develop. 
Fortunately, he had a head start 
since the team already had six years’ 
experience of using a similar sealed 
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The orange RW41 is clearly 
visible on the back of this whale 
“inthe bay of Puerto Madryn 


container tracking device. Compared 
with previous efforts, he says it 

was “extremely quick and simple 
development work with Raspberry 
Pi.” It also offered a greater range 

of possibilities: “It was much more 
than we had imagined, and at very 
low cost.” 

While there are numerous devices 
available for monitoring wildlife 
behaviour, using technology such as 
VHF telemetry or the Argos system, 
the Raspiwhale is the first to feature 
a fully functional computer with 
an operating system. According 
to Daniel, there are three key 
advantages of having a Raspberry Pi 
on board: low cost, ease of use, and 
the ability to use multiple sensors 
simultaneously. “The huge amount 
of information online, forums, 
and the Raspberry Pi community 
makes [for] easy implementation of 
complex sensors, storage, analysis 
and downloading of data, and so 
on.” In addition, the Pi’s GPIO 
connection and large number of 
protocols make it easy to implement 
“ideas for measuring environmental 
aspects, whether [about an] animal 
or its environment.” 

While the RW1’s IMU (inertial 
motion unit) tracks a whale’s 
movements (including speed, 
rotation, and compass bearing) with 
ereat accuracy, the inclusion of the Pi 
enables the collection of a wide range 
of key data, such as temperature 
(whale and sea), darkness, 
photosynthesis activity, whale heart 
rate, muscle activity, swimming 
patterns, and indicators of stress. An 
attached HD camera captures often 
dramatic video footage and stills. 


raspberrypi.org/magpi 


Testing times 

So far, two RW1 models have been 
built and field-tested: they are 
required to work at depths of up 

to 100m and survive collisions 
with animals weighing 40 tons. 
Each device is placed on a whale 

— attached with non-invasive 
suction cups, so as not to harm the 
animal — using a long carbon-fibre 
pole extended from a boat. As well 
as transmitting its position, the 
RW1’s XBee radio module enables 
two-way communication with 

a remote human operator who 

can set each of the sensors and 
download data, videos, photos, 
and sound recordings. 

Daniel tells us the system is 
already producing some positive 
results. “In tests, we could 
record dives of a mother with 
her cubs, [monitor] behaviour 
of reproduction and feeding, 

[and record] vocalisation with 

the hydrophone and video 
simultaneously.” In 2016, the team 
plan to use Raspiwhale to record 

at least 30 sessions of diving and 
Situations involving interaction 
between whales and boats. 

Much to Daniel’s surprise, the 
project has already attracted the 
interest of other wildlife research 
teams around the world: due to its 
use of low-cost hardware and open- 
source software, other researchers 
could easily adapt the device for 
their own purposes. Meanwhile, 
Daniel is planning to develop a 
smaller version of Raspiwhale to use 
on dolphins, and reckons the tiny 
Pi Zero opens up some interesting 
new possibilities. 


Daniel's Ideas Pi website (ideaspi.com) lists 
numerous planned projects using the Raspberry 
Pi, ranging from a weather station to a metal 
detector. He tells us that his next goal is 

the development of a water level/quality 
measurement station for the mining industry. 
“The idea is that both mining companies and 
partner communities can develop their projects to 
have low-cost workstations, networked to monitor 
the quantity and quality of water, as it changes 
over time, in regions where mining takes place.” 


In October 2015, Raspiwhale 


won first prize in the category 


‘New technologies in scientific 
research’ at Argentina's 
prestigious Innovar event - 

a government-backed annual 
innovation competition that 
featured entries from over 1,300 
projects in 2015. The award was 
presented to a delighted Daniel 
Pérez Martinez (left), Dr Marcelo 
Bertellotti, and Belen Arguelles. 
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News 


YASMIN BEY 


IGITAL GIRL OF 
HE YEAR 2015 


How a young computer hobbyist discovered the Raspberry Pi and 
won a European award for computing in the same year... 


DIGITAL 


MISSION: 
Recognising 
outstanding 
girls in digital 


sectors around 


the world 


REGION: 
Europe 


PART OF: 
The Ada 
Awards, a 


global award 


network 
named after 
computing 
pioneer Ada 
Lovelace 


WEBSITE: 
digital 


girlaward.com 
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hen you’re a kid, you 

have to make the difficult 

choice of what kind of 

career you want to go into without 

really having the life experience 

necessary to properly choose what 

you’d like to do. For Yasmin Bey, 

a Year 10 student doing her GCSEs, 

the decision is not that tough. 
“Probably an AI specialist. It’s 

definitely a field I would like to 

go into,” Yasmin confidently 

tells us. That’s her second choice 

after starting her own business 

as well — one in the tech and 

computing sector. Even at 15, 
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: 
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she’s already experienced enough 
with computing to know it is what 
she loves, and her efforts have 
been rewarded by winning the 
prestigious Digital Girl of the Year 
award for 2015. 

“Tt was really, really cool. So 
cool,” Yasmin says of winning the 
award. “When I heard how many 
people applied for it — I think it 
was in the 30,000s — I was amazed. 
If you do the maths and figure out 
your chance of actually winning, 
[the odds] are rather substantial.” 

Entry was via video where 
applicants had to answer questions 


Yasmin meets Carrie-Anne Philbin, with a cameo from Astro Pi 
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pertaining to them and their 
interests in tech and computing. 
There was also a practical element, 
according to Yasmin: 

“For instance, I showed the 
skills I learned from my interests 
in technology... an incomplete 
Traffic HAT (magpi.cc/i1Mma7oD) 
and then a complete one, with 
the soldering, etc. I then did some 
footage of the robot I made for Pi 
Wars as well.” 

By her own admission, she feels 
the video was cringeworthy (don’t 
we all when we make videos of 
ourselves?). It did, however, win 
her the prestigious award. 

Yasmin’s interest in computing 
started incredibly early, around 
the age of four or five, when she 
decided to make a website: 

“T kind of liked that ona 
website you have the power to put 
whatever you want on it, so I just 
decided to make my own. It had 
really ugly marquee tags and Comic 
Sans. From there, though, I learnt 
that there are more languages than 
just HTML and CSS, and then began 
making JavaScript sites.” 

At that age, she was unable to 
learn more from school - “I don’t 
think school knew what HTML 
was!” — so the next best place 
was learning on YouTube. A prime 
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The robot Yasmin 
entered in Pi Wars 
December 2015, 
less than a year 
after getting a 
Raspberry Pi 


learning resource for kids now 
that wasn’t available even 15 years 
ago, the video hosting site enabled 
Yasmin to learn Python from 
watching educational videos. 

Despite being so well known in 
the Raspberry Pi community, and 
winning this award in part thanks 
to her experiences with the Pi, 
Yasmin only got her first Raspberry 
Pi in February 2015. 

“T heard about it through 
school,” she recalls. “That’s an 
amazing story about how! found 
out about it actually. I was helping 
my friend with their Python 
homework and their computing 
teacher posted on their VLE page 
a link to the Southend Raspberry 
Jam. It said if you’re interested 
in Minecraft, programming, or 
Raspberry Pis, then come to this. 
And I thought, I like Minecraft, | 
like programming, what is this 
other thing” 
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After attending the event 
in November 2014, she decided 
she wanted to get a Raspberry Pi, 
but was too late to ask for it for 
Christmas. Instead she got it for 
her 14th birthday the following 
February. As well as making the 


As well as winning Digital Girl 
of the Year, Yasmin has been 
nominated for the 2016 FDM 
everywoman in Technology 
Awards. These awards are for 
women who are role models in 
the tech sector, showing that 
women work in STEM industries 
too, as a way to inspire young 
girls and women to keep on with 
STEM subjects if they want to. 
Yasmin is a finalist for the One 
To Watch award, among other 
school and university students. 
Clearly, the rest of the world 

is beginning to take notice of 
Yasmin and her abilities. 


it forward with the Wii Remote, 
then it would move Steve in real- 
time as well. So as you go forward, 
Steve would go forward.” 

Yasmin is a fantastic example 
of the way that online resources 
and easier access to coding 


I was amazed... If you do the 
maths and figure out your 
chance of actually winning 


robot for Pi Wars that was featured 
in her application video, Yasmin 
has been doing a lot of inventive 
Minecraft Pi hacking: 

“T had a Raspberry Pi that was 
streaming to a monitor. It would 
display where you are in Minecraft 
based on where the connected 
robot was. So, say, you’d move 


tools and hardware can really 

help teens express themselves 
and have fun with computing. 

Her success beyond this 

is well earned, though, and thanks 
to it she is currently writing a 
book as well. We’re sure that she 
will continue to be a success in the 
years to come. 
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Shortly after 
this issue 
comes out, 
Yasmin will be 
announcing 
an exciting 
new product 
that might 
pique your 
interest. We'll 
be covering 

it in the 
magazine 
next issue, but 
keep an eye 
on Yasmin's 
Twitter feed 
(@RPi_Yaz14) 
if you find 


yourself 
feeling a bit 
impatient to 
wait that long. 
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Celebrate Raspberry Pi's 
Ath Birthday with 


“HAPPY BIRTHDAY the Maker's Laptop 
RASPBERRY Pil" Use discount code 


_ PLTOP TEAM HAPPYPIDAY 


to receive free shipping 
on all pi-top Laptop 
purchases made on 

14 March 2016. 
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» The board 
works with 
any number of 
Pi Zeros 


» From idea to 
completion, the 
cluster took six 
weeks to build 


» ACompute 
Module is used 
in the Actbulb 


» The team have 
been studying 
the VideoCore 
GPU for future 
projects 


» The board is 
20cCM x 20CM x 
5cm, even with 
Pis attached 
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A full-size USB port 
is wired up to each 
Pi Zero 


16 Pi Zeros working in 
parallel means 16 1GHz 
cores and 8GB of RAM 
are available 


The board is powered by one 
supply on the rear that can 
activate all 16 Pi Zeros 


CLUSTER BOARD 


Turn your Raspberry Pi Zeros into a number-crunching cluster 
of computers with this custom-made board 


hen the Raspberry Pi Zero 

was being made, Eben 

Upton mentioned to us 
how one box of Pi Zeros holds 
hundreds of them. Hundreds of 
cores and hundreds of gigabytes 
of RAM - acrate of power, if used 
correctly. We never managed to 
work out the FLOPS one box could 
theoretically process, even if that 
might not be feasible. However, 
a Japanese company also saw the 
power of the Pi Zero in numbers 
andnas @reatedk tie! 1 Zero Glisten 
Board, which allows up to 16 Pi 
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Zeros to do parallel computing. 
We spoke to Koichi Nakamura, 
representative director of Idein, 
Inc, about the cluster board: 

“When I was playing with 
Raspberry Pi Zero, I realised that 
costs of cables and adapters are 
relatively expensive, and found 
a solution that used micro USB 
plugs for cradles. I used this idea 
(OrerealelOul Commuter elisten. 
I think it’s useful for many other 
projects, [but it was] originally 
designed and developed for our 
internal purposes.” 


Idein is currently developing the 
Actbulb, a Pi-powered sensor suite 
that fits into standard lightbulb 
sockets to use in any way you See fit. 
Sensors include a microphone and 
cameras; it’s also internet-enabled 
and has an audio speaker. 

“Since we are developing products 
using Raspberry Pi, we needa 
cluster of many Pis for software 
development and tests,” Koichi 
explains to us. “It’s also useful to set 
up many other devices... We plan to 
create a cluster to enable setup of 
hundreds of our devices a day.” 
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-. The Pi Zero is plugged in via its 
micro USB power and data ports. Each 
unit also requires an SD card with an 
operating system installed 


It’s had a huge reaction online, 
with many people excited by the 
idea of the board. However, Koichi 
believes it’s quite a simple project: 

“PiZero Cluster Board is just a 
collection of 16 identical circuits. 
eekeln Cicely, Gicenis Cun Ie InSite 
port and one USB port from [each] 
Raspberry Pi Zero’s micro USB 
port, using an SMSC LAN9512 chip. 
There are also 16 power supply 
circuits to generate 5V and 3.3V 
from a12V single power source for 
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The Pi-powered sensor that 
necessitated the creation of the Pi 
Zero cluster board. It attaches to 
standard light fittings 
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A Actbulb 


We plan to create a cluster to 
enable setup of hundreds of 
our devices a day 


Raspberry Pi Zero and LAN9512. All 
16 circuits are the same.” 

With Pi Zeros in short supply, 
the team were unable to secure 
SIMOUAI WO) CTO Ee LS ClUSueN 
at first. Fortunately, we at The 


The insides of Actbulb are a lot more 
complex than a normal light bulb 
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MagPi managed to call in every 
favour, pull every string, and beg, 
plead and borrow to get them the 
Sina, mee US, Ie) Zeros nen invereales. 
for tests. 

Due to the popularity of the 
board and its many uses, Koichi 
plans to put it on Kickstarter once 
they’re ready to crowdfund it. It 
will be an improved version of the 
prototype we’ve seen online. 

“In our current plan, the number 
of Raspberry Pi Zeros and USB 
ports is reduced to 14,” Koichi tells 
us. “We’ll also add an on-board 
Ethernet switch to the board, and 
the number of ports is reduced 
to two.” This improvement will 
reduce the number of Ethernet 
ports and cables required, and so 
lower the board’s overall cost. 


: 
Zee S333 9 


i ay rity? 


March 2016 MdgPi 35 


STEAMPUNK 


This Raspberry Pi reimagined for the 19th century is a wonderful thing. 


Lucy Hattersley talks to its maker, Jean Gaillat 
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The magnifying glass 


Q e [ : expands the tiny screen 
Facts i The stand is hand-made 


from an old curtain rod 


» With Kodi 
Remote, it can 
be controlled The trumpet makes the 
from a phone audio sound just like an 
| | old record player 
» All the parts 


cost less 
than €20 


» The ear 
trumpet comes 
from an old 
bike horn 


» The screen has 
a resolution of 
640x480 


» Jean also 
uses it as an 
internet radio 
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ave you ever wondered 
what it might have been 
like if the Victorians had 
owned Raspberry Pis® Wonder 
no more, as French maker Jean 
Gaillat has built this marvellous 
steampunked Pi that brought his 
future-retro dream to life. 
“The Steampunk Pi is my Jules 
Verne-like mechanism,” says 
3 Jean. “I can see my loved 
one’s pictures or videos 
[through] a big magnifying 
elass and listen to very 
old songs or records 
through an old ear 
trumpet. This is the kind 
of stuff I would have been 
so happy to find in the attic 


\ 
N 


a of my grandparents’ house 


when I was a young boy. 

“Steampunk looks good,” he 
continues. “I don’t know exactly 
why, but I suspect it has something 
to do with all the machines I saw in 
my grandfather’s storeroom - he 
was a wheelwright.”’ 

The Raspberry Pi is housed inside 
a wooden box, complete with stand, 
magnifying glass, and a glorious 
ear trumpet. “I bought the box for 
two euros in the Cultura shop near 
my town,” Jean tells us. (Cultura 
is a chain of creative workshops in 
France; cultura.com). Jean covered 
the wooden box in Bomb varnish 
and placed a Raspberry Pi inside. 

Once the Pi was inside the 
wooden box, it was time for some 
accoutrements. “The ear trumpet 
comes from a very old bike horn,” 
reveals Jean. “It’s supposed to 
amplify the sounds coming from 
a tiny loudspeaker in the box. The 
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sound is exactly what I wanted - just 
like from an old telephone.” 

Jean bought the magnifying glass 
for 12 euros in a store in Lyon that 
specialises in devices for camping. 
“T had seen this glass and said to 
myself, ‘Oh yeah, that’s just what I 
want for my Steampunk Pi.’ There 
were LEDs in it. I pulled out the 
LEDs and battery and kept the glass. 
It’s fair to say that this isn’t the 
kind of screen that’s comfortable 


The sound 1s exactly what I wanted 
- Just like from an old telephone 


for long shows, but it’s interesting 
to scrutinise and see my children’s 
smiling faces through it.” 
Obviously, the sound and 
vision aren’t as good as a high- 
definition monitor, but it works 
surprisingly well. “I stare into 
the glass on the front to watch 
movies — at one or two metres 
it’s acceptable,” says Jean. 
With the sound and vision up and 
running, it was time for Jean to turn 
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The Steampunked Pi 
is aretro device with 
modern capabilities 


Taye 
" 


the Steampunk Pi into an artistic 
object. We particularly like the 
Victorian stand. “I made it by myself 
using part of a golden curtain rod,” 
says Jean. The rod is fixed with screws 
to an old rusty iron oil lamp support. 
“This is a recurring dream,” 
explains Jean, “to retrieve the very 
soul of our past, bypassing centuries 
using a kind of time machine. | 
have built this thing only to put it 
somewhere, where it can be found 


by achild in the future. But I have to 
solve the issue of an empty battery 
power unit.” 

Jean is planning to add speech 
to the machine next, in his native 
French of course. “Like [Iron Man’s] 
J.A.R.V.LS,” he says, “talk to the 
thing and the thing answers: ‘Oui 
maitre. Que puis-je faire pour 
vous®’ I want to build the internet of 
talking things: steampunked talking 
things... waouh!” 


 Theresult looks right at 
home as a piece of art 


STEAMPUNK PI 


Projects 
STEAMPUNKING A PI 


>STEP-02 
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As the IR range is mostly heat, 
the sky will be darker than 
usual, while other objects are 
highlighted unusually 


nfrared (IR) cameras are 

traditionally used in low- 

light situations. Typically, 
IR is used in security cameras at 
night, and you can also implant 
an IR camera into your birdhouse 
for a live view of some hatchlings. 
Using it in daytime for ‘normal’ 
photos, though, is something 
quite unusual. However, it’s what 
Krzystof Jankowski decided he 
wanted to do using a Raspberry Pi 
and the Pi NoIR Camera Module. 

“T’ve been a photographer for 

many years and I’ve always wanted 
to take surreal (at least to our eye) 
infrared photos,” Krzystof tells 
us, “but there was no commercial 
camera that can do that easily. Also, 
those cameras for astronomers 


» Itwas tested 
and completed 
ina morning 


» Krzystof likes to 
make different 
portable 
projects using 
Raspberry Pi 


» Krzystof plans 
to makea 
smart wall 
with RSS feeds 
and stats 


» He plans to 
work with 
Arch next 


» The project 
uses a Bt and 
not a Pi 2 or 3 
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were always pricey. Using filters 
was too time-consuming and 
requires using high ISO. 

“When I was ready to buy the 
[Pi] Camera Module, I chose the 
NolIR to test how it works. After 
the few first tests, it turned out it 
works perfectly fine, but using it 
with wires, monitor, keyboard, and 
making photos by command line 
was absolutely not fun. A camera 
needs to be small and have a 
physical button to make photos.” 

Krzystof made a prototype “using 
a lot of duct tape” and went for 
a walk with it. It worked as he’d 
hoped, so he began work on a more 
robust and easier-to-use version. 

“For me it was very easy as | 
know Linux, programming, and 
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Take surreal, IR photos during 
the daytime for a slightly 
different Look at the world 
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It works roughly like a normal 
camera — just point and shoot 
to take a photo! 
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Never mind a portable Raspberry Pi camera - how about a portable 
Pi IR camera for taking stunning and unique shots: 


soldering,” he explains. “I think 
that even for newbies it will still 

be easy. The whole thing is fairly 
basic to make yourself: connect 
camera, solder button and LED on, 
put wires to proper GPIO ports, and 
download my script and installa 
few required packages.” 

His custom script is what makes 
it possible, and is downloadable 
from GitHub (magpi.cc/1K2PRgi). 
It’s only 23 lines long, but it has 
some tweaks to the way photos are 
taken to get them to look the way 
they do, and to optimise the speed 
as well, according to Krzystotf: 

“There’s a small lag like in early 
digital cameras. For landscape 
photography it’s absolutely 
acceptable, though. The only 
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downfall is the booting time: as 

it boots the whole of Raspbian, it 

takes 30-40 seconds. However, it 

can work for hours on my power 

bank without shutting down.” 
Right now, the camera is 

a little simple, and upgrades 

are planned for it eventually. 

Software-wise, Krzystof wants 

a software shutdown to prevent 

data corruption, but he also 

wants to add a small OLED screen 


Boot process 


There's no switch just yet, so plugging 
in the portable battery turns it on. This 
boots Raspbian on the Pi, and an LED 
turns on and then off once the camera is 


ready to go. 
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Glare produces amazing effects when delving beyond the range of visible light into IR 
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for a live preview and settings. 
These settings would then be 
changed with additional switches 
on the build. 

Krzystof has done many little Pi 
projects himself and doesn’t plan 
to stop here: “I encourage people 
to experiment with Raspberry Pi 
= Selcln MTOECL S ali OOO IAN AY 
to learn something new. And 
it’s always a lot of fun to make 
something yourself.” 


>STEP-02 
Take a photo 


turns the LED off. 
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Like with any camera, you just need to 
press the shutter button. This one activates 
the Python script to turn the LED on, set 
the camera up, and take the photo. It then 
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The mark two rig has a shutter button and LED to let you know 


when it’s ready, although a preview screen will be added 


>STEP-03 

Get the photo 

You could grab the photo off the SD 
card manually. However, it’s set up to 
be retrieved using SFTP over WiFi as 
well, for quick access. 
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A Raspberry Pi-powered 
smart display rises out of 


the desk 


An LED light strip is 
programmed to change 
colour and send alerts 


to the desk user 


The entire build 
took about 
18 weeks 


Frederick 
divided the 
project into 
sub-tasks to 
stay motivated 


The monitor 
lift is a drawer 
mechanism 
turned 
sideways 


The time it 
takes the 
screen to rise 
matches the 
Pi's boot time 


A USB sound 
card is used to 
power the built- 
in speakers 


Frederick is an electronics hobbyist 
and software test and integration 
engineer. One of his recent projects 
won Element 14's ‘Forget Me Not’ 
challenge. 
frederickvandenbosch.be 
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Touch controls are 
hidden in the bottom- 
right of the table. 
Tapping them toggles 
desk features on and off 


Make any desk job exciting with this futuristic PiDesk: a touch-controlled 
table with lights, sound, and a computer that rises from the surface 


so one hobbyist, Frederick 
Vanderbosch, decided to 
build this futuristic workstation. 
Complete with a touch surface, 
speakers, and a motorised display 
that rises out of the table, the 
PiDesk is one of the cleverest 
projects we’ve come across. 

“The build was part of a design 
challenge,” says Frederick. 
The Seisry ouiee compennion 
was launched by the Raspberry 
Pi Foundation and Element14 
to inspire inventors to build 
Smarter homes. 

“PiDesk is an attempt at making 
a Space-saving, futuristic-looking 
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obody wants a boring desk, 


desk,” Frederick explains. “It can 
change from a regular desk toa 
computer workstation and back at 
the touch of a finger.” 

The idea for the project came 
when he was running out of space 
in his workplace. “By combining 
a computer workstation and desk 
in one, I would be able to get extra 
Space to work when the computer 
was hidden inside the desk. For 
the project’s futuristic accents, I 
was inspired by the Tron movies, 
on which I based the light patterns 
of the desk.” 

At first glance, it looks like 
a normal desk. As soon as the 
user places their hand above a 


specific area, however, a desktop 
computer is powered on and starts 
rising out of the desk. This action 
is accompanied by visual and 
audio effects. 

“Two Raspberry Pis are involved 
in the project,” says Frederick. One 
serves as the brains of the desk; 
the second is a built-in desktop 
computer. As well as two Raspberry 
Pi units, the table contains a broad 
range of components. 

The desk itself is from Ikea. 

“Tt’s one of the cheaper models, 
which have the advantage of being 
hollow,” reveals Frederick. 

“T started by drawing some 
shapes on the desk to work out 
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where I would perform the cuts and 
emvped The clectronics: 

“Then the surface was recreated 
using two layers. The first layer 
was paper, which is used to diffuse 
the light and hide all the cuts and 
embedded clecinonics, Ime second 
layer is a large sheet of transparent 
Plexiglass, giving the desk a new 
and shiny surface.” 

Touch controls are embedded 
into the surface using a 
combination of conductive paint 


and copper tape. The paint creates 
touch-sensitive pads, while 

the tape makes a connection 

to the Raspberry Pi. 

One neat feature you might miss 
is the built-in wireless charger. 
This is a “little bonus feature | 
had in mind,” says Frederick. 

The Magic Lamp turns on when it 
is placed in the right spot. “The 
wireless charger is embedded in 
the desk, and when the lamp is 
moved on top of it, the lamp is 


powered.” The light consists of 
the wireless charger receiver, a 
microcontroller board, and a ring 
of Adafruit NeoPixels. 

If you’re thinking of building a 
similar project, then planning is 
vital. “Plan ahead and think things 
through,” advises Frederick. “Break 
down the project into smaller, more 
manageable projects. There’s a lot 
to learn by building a project like 
this because so many different 
components are involved.” 


The 
built-in LED strip 
and Magic Lamp 
are especially 
effective 
in low light 


The finished 
product isa 
usable desk witha 
display that can be 
lowered to provide 
more surface area 
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ESSENTIALS 
LEARN | CODE | MAKE 


AVAILABLE NOW: | 


> CONQUER THE COMMAND LINE 
> EXPERIMENT WITH SENSE HAT 
> MAKE GAMES WITH PYTHON 
> CODE MUSIC WITH SONIC PI 


ESSENTIALS Ma GPi i822: mags 


The 


Milf Pervemsescie From the makers of the 
official Raspberry P1 magazine 


OUT NOW IN PRINT 


ONLY £3.99 


from 


raspberrypl.org/magpl 


GET THEM 
DIGITALLY: 


Tutorial 


SIMON MONK 


Simon Monk is the author of 

the Raspberry Pi Cookbook and 
Programming the Raspberry Pi: Getting 
Started with Python, among others. 
simonmonk.org / @simonmonk2 
monkmakes.com 


CONTROLLING A 
LINEAR ACTUATOR 


Solve real-world electronic and engineering problems with your Raspberry P1 
and the help of renowned technology hacker and author, Simon Monk 


his project shows you how you can use an however, if you find that the Raspberry Pi resets itself 
ROW incor ultrasonic sensor as a proximity detector when the motor starts to move, add a separate 5V USB 
actuator (eBay) to trigger the extension or retraction of a power supply to the Raspberry Pi. 
RasPiRobot powerful linear actuator, capable of opening and Linear actuators can be quite expensive. The cost 
V3 (Amazon, closing doors and windows. usually depends on the travel (how far the shaft 
eae As you’ ll see from the list of required components, moves in and out) and the power. The one we’ve used 
HC-SRo4 this project uses a RasPiRobot Board V3 (RRB3) to here costs about £30 (S50), has a travel of 150mm, and 
areal control the linear actuator’s motor and also providea _a pull or push force of 1500N. If you search eBay for 
(eBay) handy connection for the HC-SRo4 rangefinder. The ‘linear actuator’, you may well pick up a bargain. 
Pi AN pada RRB3 also supplies your Raspberry Pi with 5V power The HC-SRo4 has become the standard low-cost 
to screw adapter through the GPIO connector. This should work fine if rangefinder, and you should be able to pick one up on 
(CPC: CN19646) the RRB3 is connected to a good-quality power supply; eBay for a few pounds or dollars. 
12V DC 2A power 
supply 
Two short RasPiRobot V3 
lengths of wire - 12V linear actuator 
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Threaded bolt 


Nut and Shaft 


Linear actuators 

Linear actuators convert the rotation of a DC motor 
into a linear motion. They’re often used to open and 
close doors or windows, or to lift or lower objects. 
They use a threaded drive shaft with a nut on it that 
isn’t allowed to turn, but is free to move along the 
threaded shaft, pushing the end of the actuator 

in and out. 

To determine whether the linear actuator retracts or 
extends, you have to control the direction of current 
flowing through its motor. A motor controller like the 
RRB3 is well suited to this. The current drawn by this 
particular linear actuator is close to the maximum 
allowed for the RRB3’s motor controller chip (the 
TB8812FNG) at 800mA. However, the chip can cope 
with greater currents for a short time and has its own 
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CONTROLLING A LINEAR ACTUATOR 


DC Motor 


Gearbox 


protection circuitry that will prevent it overheating. 

You don’t have to worry about the linear actuator 
damaging itself if you keep supplying power to it when 
it has reached the end of its travel, because most 
contain an auto-shutoff feature that removes the 
power once the shaft is fully out or fully in. 


eBay alternative 

If you have a linear actuator that takes more current 
than this one, or just want a lower-cost alternative 

to the RRB3, then search for ‘L298’ on eBay and you 
should find a module like the one shown here for a few 
pounds or dollars. You will also need two female-to- 
female jumper wires and one female-to-male jumper 
wire. Use the female-to-female wires to connect the 
control pins IN3 and IN4 on the module to GPIO pins 


Tutorial 


Left 
A linear actuator 


Left A low-cost 
L298 motor 
controller 
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Tutorial WALKTHROUGH 


BUILDING 


THE PROJECT 


This is a very 
straightforward 
project to build. 
It's just a case 
of attaching 
wires to screw 
terminals and 
plugging things 
together. 


>STEP-01 

Fit the RRB3 onto your Raspberry Pi 

The RRB3 is designed to work with older Raspberry Pis 
with 26 pin headers, but will work just fine with 40-pin 
Raspberry Pis like the Pi 2, Zero, A+, and B+. Just make 
sure that you fit the RRB3 onto the end of the row of 
GPIO header pins on a 40-pin Pi. 


10 and 25 respectively on the Raspberry Pi. These are 
the same GPIO pins that the RRB3 library uses, so you 
won’t need to change the code. 

The female-to-male jumper wire has its male end 
in the motor controller GND screw terminal, sharing 
the GND screw terminal with the negative lead to the 
power supply. The other end of the male-to-female 
wire goes to GND on the GPIO connector. The +12V 
wire from the power supply goes to the screw terminal 
marked +12V. 

Connect the leads from the linear actuator to the 
screw terminals on the motor controller board marked 
OUT3 and OUT4. 


Building your project 

As always, it’s a good idea to test the project out and 
get everything working while the parts are all out on 
your workspace. Once you know all is well, you can 
box up the project and fix your linear actuator in place, 
ready to open, close or lift whatever you have in mind 
for it. Now that the hardware side of the project is 
complete, we just need to get the software running. 
The program is written in Python and uses a library 
that accompanies the RRB3. To install this, enter: 


sudo pip install rrb3 


You can also download the program for this project 
from the command line using: 


git clone https://github.com/simonmonk/ 
pi_magazine. git 
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>STEP-02 

Attach the socket adapter 

You'll need to use a couple of short lengths of wire to link 
the screw terminal adapter to the RRB3. It’s a good idea 

to use red and black wires, to make sure the red goes to 
the positive (+) terminal on both the RRB3 and the terminal 
adapter, and the black connects the negative terminals. 


To run the program, change directory to the one 
where the code for this project lives and then run the 
program using the commands below: 


cd /home/pi/pi_magazine/13_linear_actuator 
sudo python lin_act.py 


If you now move your hand in front of the 
rangefinder, LED1 on the RRB3 should turn on and the 
linear actuator should start to extend. Once the linear 
actuator is fully extended, it will stop. When LED1 
goes out, waving your hand in front of the rangefinder 
will start the actuator retracting. 


How the code works 
The Python code for this program is well commented. 
You’ ll probably find it handy to have the code up in an 
editor while we go through it. 

The program starts by importing the rrb3 library 
that it needs. The constant T is set to slightly longer 
than the time taken in seconds for the motor to 
extend or retract fully, whichever takes longer. This 
is how long the motor will be asked to run for when 
retracting or extending. Remember that the motor will 
automatically cut out at each end of its travel. 

The extended variable is used to keep track of 
whether the linear actuator is extended or not. The 
main while loop waits for the rangefinder to detect 
something closer than 20cm from it and then either 
sets the motor to run forward or in reverse, depending 
on the value of extended. For good measure, one of 
the LEDs on the RRB3 is lit while the motor is being 
powered, and a message is printed out. 
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>STEP-03 >STEP-04 


Connect the linear actuator Fit the rangefinder 
Connect the two leads from the linear actuator to the pair of Finally, attach the rangefinder to the RRB3 in the socket labelled 
terminals marked ‘R’ on the RRB3. The red lead from the linear ‘HC-SRO4’ At this point, you can also attach the power supply 
actuator should go to the terminal nearest the two power terminals. to the adapter socket and, if you wish, disconnect USB power 

If, when you test the project, the motor moves in the opposite from the Raspberry Pi, although it won't do any harm if you don't 
direction to what you were expecting, swap over these two wires. disconnect the USB power. 


The whole while loop is contained ina try / 


finally clause so that when the program is quit using lin act 
CTRL+C, the GPIO pins are set back to be inputs. — Py 


Using your linear actuator from rrb3 import * DOWNLOAD: 
Linear actuators like the one used here are actually from random import randint mag pber /aewce 
very strong. If you have any doubt as to the power 
of one of these devices, take a look at this video — re = RRB3(12, 12) # Battery voltage 12V, motor 12V 
youtu.be/qbWMEIFnq2I — which shows a can-crusher 
using this linear actuator, built by your expert for T = 20 # 20 seconds to extend 
his book Make: Action: Movement, Light, and Sound with 
Arduino and Raspberry Pi. extended = False 
If it will crush cans, however, it will crush fingers, 
so be careful! try: 
A common use of linear actuators is to automatically while True: 
open a Skylight window when the temperature if rr.get_distance() < 20: 
exceeds a certain point. You could use a temperature if extended: # if extended retract and vice versa 
sensor with this project, such as the DC18B20, print("retracting") 
and even add a web interface to control things re.set_ledi(True) # LED 1 on 
from your browser. rr.reverse(T, 1.0) 


rr.set_ledi(False) 


extended = False 
THE END cise: 


print("extending") 
This article is the last in my Everyday Engineering 
series. | hope you have enjoyed all 13 projects in the rr.set_led2(True) 
series as much as | have devising them. If you like my rr.forward(T, 1.0) 


writing, then you'll probably enjoy my books, especially rr.set_led2(False) 


Programming Raspberry Pi, The Raspberry Pi Cookbook, 

and The Maker's Guide to the Zombie Apocalypse. 
Finally, this is not goodbye as The MagPi will be print("done") 

serialising excerpts from my book Programming finally: 

Raspberry Pi: Getting Started in Python over the 

next few months. You can also follow me on Twitter 


extended = True 


rr.cleanup() # Set all GPIO pins to safe input state 


via @simonmonkz2. 
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Cat Cam 


Send An Email oF 
Call A Web Hook of 


Run A Command Om 


Command /data/pushover py 


DD PUSH 


» © WESLEY ARCHER 
| 4 (AKA RASPBERRY COULIS) 


4 Self-taught Raspberry Pi enthusiast, 
now writing guides for Pi Supply's 
i= @ Maker Zone to help others get 
_. involved in gadgety goodness! 
Raspberrycoulis.wordpress.com 
Facebook.com/raspberrycoulis 
@RaspberryCoulis 


Busted! This is what your 
camera sees (and records) 
when motion is detected 


This is where you'll tell 
MotionEyeOS to run 
your Python script 


me NOTIFICATIONS TO 


magpi.cc/ 
12UCwiJk 


> Raspberry Pi 
Camera Module 


> Pushover app for 
iOS or Android 
with full licence 


een MotionEyeOS is perfect for using your Pi as a CCTV camera. Want to detect 


pushover.net 


ne benefit of MotionEyeOS is its ability to 
detect motion and capture images and movies 
of what triggered it. You can also access a live 
stream of your camera online, even when you’re not 
home, which is handy if you want to check in every 
now and then. When away from home, being notified 
of any movement is very useful, and MotionEyeOS has 
a nifty option for custom notifications. 
This guide will assume you have already set up 
and configured MotionEyeOS. A Pushover licence is 
required, which costs £3.99/S4.99. For help, check out 
the MotionEyeOS wiki here: magpi.cc/1UCVYwV. 


Make sure 

you turn on ‘Run 

A Command’ and 
then include the 


path to your script! Send An Email 


Call A Web Hook 


Run A Command ON 


Command /|/data/pushover.py 
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movements while you’re out? Then read on... 


Create an application in Pushover 

Pushover has a great, easy to use API. Before we start, 
we need to register an application with it. Click on 
Register Application under the Your Applications 
heading on the Pushover website (pushover.net). Give 
your app a name — something like RaspiMotion — and 
then make sure the type is Application. Give your app 
a quick description (e.g. ‘Push notifications sent by 
my Raspberry Pi’) and, if feeling creative, upload a 
custom icon which will show in your Pushover client 
app whenever a notification is sent. 


Get your API token and user key 

Once you have created your application, you should 
have access to an API token/key. This is a unique 
combination of numbers and letters — please keep 
this a secret! You’ll also need your user key, which 

is shown once you log into Pushover’s website. 

Okay, so you have an app and your API and user keys. 
You'll now need to download (or recreate if you so 
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ADD PUSH NOTIFICATIONS TO MOTIONEYEOS 


pushover. py 


import httplib, urllib 


Gon = 
conn.request("POST", "/1/messages.json", 
urllib.urlencode({ 
"token": "APP TOKEN", 
“user: “USER _TOKEN-, 


AEM 2b 

"title": "Motion Detected!", 

"message": "<b>Front Door</b> camera!", 
THLE 2 Hetps yy / EP ADDRESS 

"url title": "View live stream", 
"sound": "siren", 


httplib.HTTPSConnection("api.pushover.net:443") 


>PYTHON 


DOWNLOAD: 
magpi.cc/ 
20DHpYW 


Insert app token here 

Insert user token here 

1 for HTML, 9 to disable 

Title of the message 

Content of the message 

Link to be included in message 
Text for the link 

# Define the sound played 


+ HH H HH FF OF 


}), { "Content-type": "application/x-www-form-urlencoded" }) 


conn.getresponse() 


wish) a simple Python script to tell your Raspberry 
Pi to work its magic once the script is called upon 
by MotionEyeOS. 


>STEP-03 

Create your Python script 

MotionEyeOS is not like Raspbian. You cannot use 
certain commands as you would normally, such as 
git clone, so we’ll have to create our Python script 
manually; you can also drag and drop using WinSCP 
if preferred. We also don't need to use sudo, as we’re 
already logged in as root by default. Our script needs 
to live in the data folder, so let’s go there and create 
pushover.py using nano: 


cd /data 
nano pushover.py 


Once here, you’1l need to copy and paste or type in 
the code listing, while also including your API token 
and user key where required. 


>STEP-04 

Make your script executable 

As with any script, we need to make sure it can be 
executed, otherwise it's nothing more than a fancy 
collection of text! You can do this either from the 
command line or from within WinSCP. From the 
command line, make sure you're in the data folder 
and then type: 


chmod +x pushover.py 
Or, if using WinSCP, select the pushover. py file in 
the data folder, then press F9. In the window that 


appears, change the permissions to 0755 and then click 
‘OK’ to confirm. 
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Create New Application/Plugin 


m8 Tae? Oe ee 


Apo cation Intonneior 


hon [ Si Mm co Left Create an app 
oa sain . via Pushover.net to 
get the ball rolling. 
It's pretty self- 
explanatory 


>STEP-05 

Configure MotionEyeOS to use your script 

Now that we have our script, we need to tell 
MotionEyeOS to use it when it detects motion. To 

do this, log in, go to the Motion Notifications menu 
and turn on the ‘Run A Command?’ option. You then 
need to specify which command to run, which will be 
the Python script you just created — this is 
/data/pushover.py. Click Apply once done, to 
confirm the changes. 


>STEP-06 
Test it out! 
Hopefully, by now you have created your Python 
Script, made it executable, told MotionEyeOS to use 
your script when it detects motion, and have the 
Pushover app installed on your smartphone or tablet. 
We now need to test that it works! Wave your hand in 
front of your camera (or you can do a dance if you're 
feeling energetic!) and then shortly afterwards you 
should receive a notification via Pushover, warning 
you that motion has been detected! 

Feel free to experiment with the script to 
customise the message displayed and sound played 
in Pushover. 
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Tutorial 


))) Sonic Pi 


YOUR SOUND 


o far during this series, we’ve focused on 
triggering sounds. We’ve discovered that 

we can trigger the many synths built into 
Sonic Pi with play or synth, and how to trigger pre- 
recorded samples with sample. We’ve also looked at 
how we can wrap these triggered sounds within studio 
FX such as reverb and distortion, using the with_fx 
command. Combine this with Sonic Pi’s incredibly 
accurate timing system and you can produce a vast 
array of sounds, beats, and riffs. However, once 
you’ve carefully selected a particular sound’s options 
and triggered it, there’s no ability to mess with it 
whilst it’s playing, right? Wrong! Today you’re going 
to learn something very powerful: how to control 
running synths. 


Raspberry Pi 
running Raspbian 


Sonic Pi v2.7+ 


Speakers or 
headphones with 
a 3.5mm jack 


Update Sonic Pi: 
sudo apt-get 
update && sudo 
apt-get install 
sonic-pi 


A basic sound 

Let’s create a nice simple sound. Fire up Sonic Pi and, 
in a fresh buffer, type the following: 

synth :prophet, note: :e1, release: 8, 
cutoff: 100 


EE [-)sonicri (Ge GB > @)Lsa}is2 


’ |e) 
ston 


“L control node 99, 


with_fx :echo, mx: 0, mx_slide: 8 do |fx| 
control fx, mx: 
ia 


notes scale :e3, :mnor pentatonic, num octaves: 


[Run 2, Time 52.5, T 


sn = synth :proponh , Sustain: » HEteS § , cutorTT | - 
creel = tie era , ——— _ control node 99, 
Leep 2 
times do | . [Run 2, Time 52.625, 
pa sn, note: notes.tick, pan: rrand 7 L_ control node 99, 
ena 
end [Run 2, Time 52.75, 


“ control node 99, 


[Run 2, Time 52.875, 
— control node 99, 


BufferO Buffer] Buffer2 Buffer3 Suffer4 Buffer5 Buffer6 B 
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In this month’s Sonic Pi guide, creator Sam Aaron shows you 
how to shape and sculpt your sounds... 


Now press the Run button at the top left to hear a 
lovely rumbling synth sound. Go ahead, press it again 
a few times to get a feel for it. OK, donee Let’s start 
controlling it! 


Synth nodes 

A little-known feature in Sonic Pi is that the fns 

play, synth, and sample return something calleda 

SynthNode, which represents a running sound. You 

can capture one of these SynthNodes using a standard 

variable and then control it at a later point in time. For 

example, let’s change the value of the cutoff: opt 

after one beat: 

sn = synth :prophet, note: :e1, release: 8, 
cutoff: 100 

Sleep 1 

control sn, cutoff: 130 


Let’s look at each line in turn... 

Firstly, we trigger the :prophet synth using the 
synth fn, as normal. However, we also capture the 
result in a variable called sn. We could have called 
this variable something completely different, such 
as ‘synth_node’ or ‘jane’ - the name doesn’t matter. 
However, it’s important to choose a name that’s 
meaningful to you for your performances and for 
people reading your code. We chose snas it’s anice 
short mnemonic for synth node. 

On line 2 we have a standard sleep command. This 
does nothing special — it just asks the computer to 
wait for one beat before moving onto the next line. 

Line 3 is where the control fun starts. Here, we 
use the control fn to tell our running SynthNode 
to change the cutoff value to 13@. If you hit the 
Run button, you’ll hear the : prophet synth start 
playing as before, but after one beat it will shift to 
sound a lot brighter. 
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Multiple changes 

Whilst a synth is running, you’ re not limited to changing 
it only once — you’re free to change it as many times as 
you like. For example, we can turn our : prophet into a 
mini arpeggiator with the following: 


notes = (scale :e3, :minor_pentatonic) 

sn = synth :prophet, note: :e1, release: 8, 
cutoff: 100 

Sleep 1 

16.times do 
control sn, note: notes.tick 
Sleep @.125 

end 


In this snippet of code, we just added a couple of extra 
things. Firstly, we defined a new variable called notes, 
which contains the notes we’d like to cycle through (an 
arpeggiator is just a fancy name for something that cycles 
through a list of notes in order). Secondly, we replaced 
our single call to control with an iteration calling it 16 
times. In each call to control, we .tick through our ring 
of notes, which will automatically repeat once we get to 
the end (thanks to the fabulous power of Sonic Pi’s rings). 
For a bit of variety, try replacing . tick with . choose and 
see if you can hear the difference. 

Note that we can change multiple opts 
simultaneously. Try changing the control line to the 
following and listen for the difference: 


control sn, note: notes.tick, 
cutoff: rrand(70, 13@) 


Sliding 
When we control a SynthNode, it responds exactly on 
time and instantly changes the value of the opt to the 
new one, as if you’d pressed a button requesting the 
change. This can sound rhythmical and percussive — 
especially if the opt controls an aspect of the timbre, 
such as cutoff:. However, sometimes you don’t want 
the change to happen instantaneously. Instead, you 
might want to smoothly move from the current value 
to the new one, as if you’d moved a slider or dial. Of 
course, Sonic Pi can also do this too using _slide: opts. 
Each opt that can be modified also has a special 
corresponding _slide: opt that allows you to specify 
a Slide time. For example, amp: has amp_slide:, and 
cutoff: has cutoff_slide:. These slide opts work 
slightly differently from all the other opts in that they 
tell the synth nodes how to behave next time they are 
controlled. Let’s take a look: 


sn = synth :prophet, note: :e1, release: 8, 
cutoff: 70, cutoff_slide: 2 

Sleep 1 

control sn, cutoff: 130 
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Modulatable options 


Most of Sonic Pi’s synths and FX opts may be 

changed after being triggered. However, this isn’t the case for all of 
them. For example, the envelope opts attack: , decay: , sustain:, 
and release: can only be set when triggering the synth. Figuring 

out which opts can and can’t be changed is simple - just head to 

the documentation for a given synth or FX, then scroll down to the 
individual option documentation and look for the phrases ‘May be 
changed whilst playing’ or ‘Can not be changed once set’. For example, 
the documentation for the :beep synth’s attack: opt makes it clear 
that it’s not possible to change it: 


> Default: o > Can not be changed once set 
> Must be zero or greater =» Scaled with current BPM value 


Note how this example is the same as before, except with 
the addition of cutoff_slide:. This is saying that next 
time this synth has its cutoff: opt controlled, it will take 
two beats to slide from the current value to the new one. 
Therefore, when we use control, you can hear the cutoff 
Slide from 70 to 130. It creates an interesting dynamic feel 
to the sound. Now, try reducing the cutoff_slide: time 
to 0.5, or increasing it to 4, to see how it changes the sound. 
Remember, you can slide any of the modifiable opts in this 
way, and each _slide: value can be totally different, so you 
can have the cutoff sliding slowly, the amp sliding fast, and 
the pan sliding somewhere in between if you like. 


Bringing it all together 

Let’s look at a short example which demonstrates the 
power of controlling synths after they’ve been triggered. 
Note that you can also slide FX just like synths, but with a 
slightly different syntax. Check out section 7.2 of the built- 
in tutorial for more information on controlling FX. 

Copy the code into a spare buffer and listen. Don’t stop 
there, though - play around with the code. Change the slide 
times, the notes, the synth, the FX, and the sleep times and 
see if you can turn it into something completely different! 


live_loop :moon_rise do 
with_fx :echo, mix: @, mix_slide: 8 do |fx| 
control fx, mix: 1 
notes = (scale :e3, :minor_pentatonic, 
num_octaves: 2).shuffle 
sn = synth :prophet , sustain: 8, note: :e1, cutoff: 70, 
cutoff_slide: 8 
control sn, cutoff: 130 
Sleep 2 
32.times do 
control sn, note: notes.tick, pan: rrand(-1, 1) 
Sleep @.125 
end 
end 
end 
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a 


Notes go green when 
you play them, and you 
hear a recording from 
Sonic Pi 


Get a note wrong and 
you hear a thud, and 
the note goes red. Keep 
trying! 
As you progress, more 


sharps and flats are 
introduced to the game 


CLEF HERO: 


CREATE A MUSIC GAME. 
USING THE PIANO HAT 


Put a piano on your Pi, and learn to tinkle the ivories. This game teaches 
you to read music and program the Piano HAT. 


Piano HAT 
magpi.cc/ 


2OALWNT 


Some speakers 
on your Pi 


Pygame Zero 
magpi.cc/ 
aXdhRji 


imoroni’s Piano HAT provides a musical 
keyboard for your Pi, with LEDs for 
illuminating the keys. In Clef Hero, you’re 
challenged to play a pattern of notes shown on the 
Stave. It starts easy, but gets harder as more notes, 
sharps, and flats are introduced. As you move up 
the stave you’ ll reuse keys for the higher octave 

so, for example, the ‘D’ key is the right answer for 
either D on the stave. Standard sheet music wouldn’t 
normally include the mishmash of sharps and flats 
you can get on the higher levels, but that makes 
Clef Hero a challenging puzzle even for those with 
some experience. 


>STEP-O1 

Make some sounds 

First, we’ ll make a single audio file that contains all 
the notes we’ll need. The Listing 1 code for Sonic Pi (on 
page 54) will play the notes in order. Enter the listing 
in one of the Sonic Pi buffer spaces. Press the Rec 
button to start recording, press Run to play the notes, 
and then press Rec again to save your recording. You 
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can customise the sounds and use different synths, 
but don’t make the sounds too long or the game will 
become unplayable. 


>STEP-02 

Split the note files 

To split your sound recording into individual files 

for each note, use Audacity. Install it by entering the 
command sudo apt-get update && sudo apt-get 
install audacity ina terminal. Open your audio 
file - the default option to make a copy to edit is 

fine, if you’re asked. From the Analyze menu, choose 
Silence Finder. Set the minimum duration to 0.10 and 
the label placement to 0.05, then click OK. Go to the 
Edit menu and click Preferences. In the Import/Export 
options, untick ‘Show Metadata Editor’. From the File 
menu, choose Export Multiple. Use the WAV export 
format, choose ‘Numbering after File name prefix’, 
and enter the File name prefix of ‘note’. Create a 
directory called clef, and a directory called sounds 
inside that. Choose the sounds directory as your 
export location and click Export. 
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clef.py 


# Clef Hero by Sean McManus 
import pianohat, random, time 
WIDTH, HEIGHT = 600, 440 

RED = (255,0,0) 

GREEN = (Q,255,@) 

BLUE = (0,0,255) 
notes to play = list() 
note_colours = list() 
level = 1 


notes data = [ 


[2, sounds.note_@1, 1, ""], [2, sounds.note_@3, 2, ""], 
[4, sounds.note_@5, 3, ""], [5, sounds.note_@6, 4, ""], 
[7, sounds.note_@8, 5, ""], [9, sounds.note_10, 6, ""], 
[11, sounds.note_12, 7,""], [@, sounds.note_13, 8, ""], 
[2, sounds.note_15, 9, ""], [4, sounds.note_17, 10, ""], 
[5, sounds.note_18, 11, ""],[7, sounds.note_20, 12, ""], 
(2. sounds note. 22 91355" jl. 

[1, sounds.note_@2, 1, "#"],[3, sounds.note_@4, 2, "#"], 
[6, sounds.note_@7, 4, "#"],[8, sounds.note_@9, 5, "#"], 
[10, sounds.note_11, 6, "#"], [1, sounds.note_14, 8, "#"], 
[3, sounds.note_16, 9, "“#"], [6, sounds.note_19, 11, "#"], 
[8, sounds.note_21, 12, "#"], [10, sounds.note_23, 13, "#"], 
[1, sounds.note_@2, 2, "b"], [3, sounds.note_04, 3, "b"], 


[6, sounds.note_@7, 5, 
[18, sounds.note_11, 7, 
[3, sounds.note_16, 10, 
[8, sounds.note_21, 13, 


] 


"b"], [8, sounds.note @9, 6, "b"], 
"b" |, (4, sounds-inote 14, 9, "b« |, 
"b"],[6, sounds.note_19, 12, "b"], 
“| 


CLEF HERO 


Tutorial 
qanguage 


del note_colours|[ : ] 
notes data[@ : level * 4] 
for i in range(8): 


level data = >PYTHON 


notes_to play.append(random.choice(level_ data) ) 
note_colours.append (BLUE) 

note_position = @ 

note_number = 0 

clock.schedule_unique(hint_on, 5) 


def draw(): 


screen. blit(images.clef_background, (2,2) ) 
screen.draw.text("Clef", (310,90), color="blue", fontsize=120) 
screen.draw.text("Clef", (315,85), color="white", fontsize=120) 
screen.draw.text("Hero", (310,180), color="blue", fontsize=120) 
screen.draw.text("Hero", (315,175), color="white", fontsize=120) 
BOX = Rect((100,290), (400,120)) 
SHADOW = Rect((105,295), (4@0,120)) 
screen.draw.filled rect(SHADOW, (0,0,0)) 
screen.draw.filled rect(BOX, (255,255, 255)) 
screen.blit(images.treble clef, (105,305) ) 
for y in range(5): 

screen.draw.line((110, 380 - y*16), (490, 380 - y*16), (0,0,0)) 
show_notes ( ) 


def show_notes(): 


for i in range(8): 
draw_note(i) 


def draw_note(note_number): 


screen.draw.filled_circle((180 + note_number * 35, 404 - notes _to play[ 


note_number][2]*8), 7, note_colours[note_number ]) 


def round_setup(): 
global note_position, note_number, notes to play 
del notes to play[: ] 


>STEP-03 

Fix your hyphens 

Audacity exports your files with names like 
note-O1.wav, note-02.wav, and so on, but Pygame 
Zero requires underscores, not hyphens. To do 
the bulk rename, we recommend you install 

mmv with sudo apt-get install mmv. Then 

cd to the sounds directory where you have the 
files Audacity exported, and enter the command 
mnv "note-*.wav" "note_#1.wav". Copy 
thud.wav into sounds too, from pi/Pimoroni/ 
pianohat/sounds/drums. It’s used when the player 
presses the wrong key. 


>STEP-04 

Prepare your art 

You’ll need a treble clef and a background image. 
We’re using a treble clef from magpi.cc/1XdhNA3 
(download the small version) and a background by 
Gerd Altmann (magpi.cc/1XdhOnK) - again, use the 
small one. Rename your clef to treble_clef.png 

and your background to clef_background. jpg. 
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Below Use Audacity 
to split your Sonic Pi 
recording into notes 


Propect Parbe (Hr: 
}4401| 


if notes_to play[note_number][2] == 1 or notes_to play[note_number][2] == 13: 
screen.draw.line((170 + note_number * 35, 404 - notes to play[ 


note_number][2]*8), (190 + note_number * 35, 404 - notes _to play[note_number ] 


>> 


{pr 
SHaction Start: @ End (> Lergth Audis Postiorr 


rap To [Gh GomOOss OOhOomsoee Oh OO moose 
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@ 
CTCh DV eCTCh 
Raz a & D _D W | |= B 


® ® unguage 
>» [2]*8), note_colours[note_number ]) {isting ] {o 
60 


screen.draw.text(notes to play[note_number][3], ( >SONIC Pl 
162 + note_number * 35, 395 - notes to play[note_number][2]*8), note = 
color = note_colours[note_number], fontsize=24) with_synth :tb3@3 do 
22.times do 
def update(): play note 
draw_note(note_position) note = note + 1 
Sleep 1.25 
def handle_note(piano_key, pressed): end 
global note_position, note_colours, level end 
if pressed == False: # key was released, not pressed 
return sounds. thud.play() 
if piano_key == 12: # if top C pressed 
piano key = @ # treat it the same as bottom C def hint_on(): 
clock.unschedule(hint_on) pianohat.set_led(notes_ to play[note_position][@], True) 
if piano_key == notes_to play[note_position][0]: 
note_colours[note_position] = GREEN def lights out(): 
notes _to play[note_position][1].play() for light in range(16): 
lights _out() pianohat.set_led(light, False) 
if note_position < 7: 
note position += 1 def lights on(): 
else: for light in range(13): 
lights _on() pianohat.set_led(light, True) 
if level < 8: clock.schedule_unique(lights out, 1) 
level += 1 
round_setup() lights _on() 
clock.schedule_unique(hint_on, 5) round_setup() 
else: pianohat.auto_leds(False) 
note_colours[note_position] = RED pianohat.on_note(handle_note) 
Resize your clef to 62110 pixels. You can use >STEP-05 
sudo apt-get install imagemagick and then Build the Clef Hero game 
convert treble clef.png -resize 62x100 The main code listing shown contains the Python 
Below UseSonic treble_clef.png to resize the image from the code for the Clef Hero game. Call it clef.py and put it 
Pitomake(and command line. Create a directory called images into your clef directory, so it sits immediately above 
iuaaieocice eed inside the clef directory and put your pictures there. | the sounds and images directories, as Pygame Zero 
thisgame This is where Pygame Zero looks for all its images. will expect. You run it with sudo pgzrun clef.py 


from LXTerminal in the desktop environment. Each 


a x level has eight notes. When you play a note correctly, 
cereals it goes green. When you complete the level, another 


GD ES oy) 


afipabers -tb303 do 4 fim mp ee _ eight notes are chosen randomly. The range of notes 
22.times do wspesee) Starts small, but increases with each screen you 
play note apes finish until all notes are in play. Tap the black notes 
note = note + 1 Apeserl carefully: it’s easy to also hit a white key by mistake. 
sleep 1.25 | 


=. saw | >STEP-O6 

ve oescooe ve Tt'S time for your solo! 
There’s lots you can do to customise Clef Hero. The 
list notes_data describes the notes - the data is Piano 
HAT key, sound file, the stave line or space numbered 
from C=1 at the bottom, and the sharp or flat symbol. 
To have notes arrive in a different order, change their 
place in this list. To play with all the notes from the 
Start, add random. shuffle(notes_data) immediately 
after notes_data is defined. Why not add a score 
or a time limit? Or adapt the game for the bass clef? 
Jam with it! 


faamples Synth Fx 
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Electronics Starter Kit 
for Raspberry PI 


This kit contains everything you need (apart from 
a Raspberry Pi) to create ten electronic projects. 


° 10 easy to follow project cards * Compatible with Pi B, B+, A+, Pi 2 

. . buzzer, light sensor, temperature sensor, 
* 20 jumper wires and capacitor 
¢ All Python code in one easy download * No soldering required 


RasPiRobot Board v3 


A simple to use motor controller for the Raspberry 


Pi. This board is designed to simplify the process £17.50 / 

of making small roving robots and controlling $25 - $29.95 

medium power loads using a Raspberry Pi. 

¢ Dual bi-directional motor control using ¢ 2 x user controllable LEDs 
TB6612FNG dual H-bridge ¢ 2 x header pins for switches 

¢ Dual open drain 2A MOSFET outputs ° Reverse polarity protection 

° Socket for HC-SRO4 Rangefinder * Open Source Python Software library 

¢ Socket for 5V I2C Interface ¢ Screw terminals for motor 

° Provides regulated power and power connections 
to Raspberry Pi ¢ Compatible with Pi, B+, A+, Pi2 


Please note: Illustration of possible use only, chassis, Raspberry Pi, motors, rangefinder etc. not included 


Raspberry Squid Combo Pack 


Using the included Raspberry Leaf GPIO template, attach an 
RGB LED and push buttons directly to the GPIO pins of a 
Raspberry Pi. The switches are panel-mountable and perfect 
when putting your Raspberry Pi project into an enclosure. 


° Includes one RGB LED Sauid and two Squid Buttons and a Raspberry Leaf GPIO template 
¢ RGB LED and switches plug directly into Raspberry Pi GPIO pins 
¢ Simple to use Python library for RGB LED control and switch debouncing 


amazoncom amazon.co.uk 


Enter promo code: MAGPINOW 


www.monkmakes.com | twitter@monkmakes 


Tutorial 


Youll 
Need 


> Raspberry Pi Zero 


> 16x \WS2812b 
LEDs - through 
hole or surface 
mount 


> GP2YOA2YKOF 
— IR distance 
sensor 


> LM339 
comparator 


> 74LS14 - Hex 
Schmitt input 
buffer 


> Stripboard & 
self-adhesive 
copper strip 


> Ikea Ribba 
picture frame 
(000.780.51) 


> Two-way mirror 
film 


> Scrap CD or DVD 


> Connectors, 
leads, resistors, 
and capacitors 


The voltage 
output of the 
GP2YOA2YKOF sensor 


56 | MdgPi March 2016 


Output Voltage (V) 


3.5 


2.5 


0.5 


20 


30 40 50 


Distance of Reflective Object (cm) 


60 


80 


y) 


LED one-turn spiral 
Interface board 


Pi Zero board 


Infrared distance sensor 


The mirror that reacts to your presence and shows you infinity 


he Raspberry Pi Zero is great for embedding 

in a project and just leaving it there, 

so we thought we would look at a project 
like this down at the Bakery. One project that has 
been on the books for some time is an Infinity 
Mirror: this is where you sandwich some LEDs 
between two mirrors and get reflections of 
reflections, all the way down to infinity. There have 
been a few published before, but not one like this. 
What's new about this one is that it has a unique 
arrangement of LEDs and reflecting surface, giving 
a different sort of pattern, as well as a distance 
sensor that triggers different patterns the closer 


you get to it. 
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Tutorial 


>STEP-01 
Make the infinity tunnel 


Find a large tube, about 10 to 12cm in diameter and 4cm deep, or you 
can roll one out of cardboard. Either way, roll your tube along a piece 
of paper to make a strip the same length as the circumference of the 
tube. Measure 5mm down from the top-right corner and 5mm up from 
the bottom-left corner, and draw a diagonal line between the two 
points. Fold the strip in half and straighten it out; where the crease 
mark cuts the line, mark a spot. 

Repeat this procedure, folding to the halfway crease line for each 
side, to obtain two more creases; again, mark the intersection of the 
line and crease mark. You now have three equally spaced points along 
the diagonal line. 

Repeat this action, folding to the other creases, until you have 16 
points marked. 


—- 


The CD creates a refraction pattern 


The project 

The project is based around an Ikea picture frame, the 
23x23cm Ribba, with the front glass covered in two-way 
mirror film. There are basically two electronics circuits: 
the first one is the distance sensor based on the Sharp 
GP2YOA2YKOF, and the second is a chain of WS2812b 
LEDs. The processor used in the Zero will run the 
Adafruit library for this chip, whereas the processor used 
in the Model 2 Pi is not currently compatible. The idea is 
that a strip of NeoPixels is arranged in a one-turn spiral 
on a tube, and at the bottom of the tube is a reflecting 
surface. We chose to make this a CD so that not only 

do you get a reflection, you also get arefraction pattern 
from the CD’s optical grating, which splits the white and 


other secondary colours into their component parts. >STEP-02 
The design Prepare the tube : : 

i Glue this paper strip around the outside of the tube and drill a hole at 
Fig 1 shows the output of the GP2YOA2YKOF sensor for , aoe 

each point. We made a support to place inside the tube to stop the 
different distances. Deore how this moa e means that drill press crushing the tube. Remove the paper strip and clean up 
ane readings are ambiguous ~ that is, one voltage the holes with a sharp knife. Paint the inside wall of the tube a matt 
reading could be one of two distances. However, this black. Put a spiral of self-adhesive copper strip to join up the tops of 
only happens for distances shorter than 5cm and in the holes; make the strip pass just 0.5mm short of the hole’s centre. 
this application it's not a problem, even if the wrong Use a second strip to cover the bottom half of the holes; the two strips 
distance is indicated. The output is analogue and the should be about 1mm apart. With a sharp knife, remove the copper 
Pi has no built-in analogue to digital (A/D) converter, that overhangs the holes. 


SO we are going to have to make one. Fortunately, this 
does not need a very high resolution as we only want to 
indicate four different distance measurements. This can 
be done simply with four comparators arranged as a 
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Tutorial WALKTHROUGH 


5V 
0.1uF 
Distance Sensor a 
| GPIO 27 
GP2YOA2YKOF T <10cm 
GPIO 23 ; a 
<20cm Step 3 Wire up the LEDs 
_ “flash converter’; the schematic is shown in Fig 2. The 
390R _ output of the sensor is fed to the negative input of all the 
_ comparators, and the positive input is fed by a chain of 
resistors across the 5V supply, giving various voltages 
at each node. The resistor values have been designed 
ae to produce voltages that correspond approximately 
to various distances, as shown in the diagram, so the 
_ output of the comparators gives you an indication of the 
cae | distance. Note that if the distance is, say, 15cm, then the 
| three bottom comparators will indicate the distance is 
_  <20, < 30, and <50. The outputs are open collector, so 
0 GPIO 17 they can be fed directly into the Pi’s GPIO pins with their 
Te 1 <50cm pull-up resistors enabled. Note also that there is a push 


_ button so that you can safely power down the project 
_ before removing the power supply. 
| The WS2812b or NeoPixel driver is shown in Fig 3. 


hk GPIO 26 This is much the same as the one we used in the String 
Fig 2 The schematic of the distance sensor's D/A an Pong project in The MagPi #35, only the pin numbers 


L _ have been changed to make the layout on stripboard 


- | >STEP-03 


0.1uF Ceramic ——> | $ 1mm Wire up the LEDs 

Glue a \WS2812b LED over each hole, making sure the 

diagonal edge marking the ground connection is next 

to the lower strip on the left-hand side. Hot-melt glue 

is good if you can be sparing with it, otherwise we used 

impact adhesive. Once the glue is dry, solder up the 

decoupling capacitors in front of each LED. Next, wire up 

the LEDs as shown in the diagram, with a wire going from 

the output of one LED to the input of the next; each LED 

is connected to the power or ground copper strip with 

a short length of wire. We used 28 AWG wire stripped 

of its insulation for this. Solder quickly to avoid damage 

to the LEDs. When complete, it's a good idea to test the 
LEDs with a program from the library's examples. Then 

oy the wires can be fixed and the LEDs reinforced with some 
hot-melt glue. 


Gnd Copper:strip 


Data 


Data Out Data In +5V 


 +5v 
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Raspberry Pi 


Make link only to power the Pi 
from the LED supply 


ony 


V—_—_—— 


0.1uUF 


Gnd 


GPIO 18 


a bit easier. The LEDs can take over an amp, so they 
need powering separately. In fact, we powered the 
whole Pi Zero from this through a couple of 5V and 
ground pins on the GPIO connector. In case this is not 


what you do, you could have a removable link to the 5V 


line. For details of the construction, see the ‘Building 
the mirror’ step-by-step section. 


The software 

You first need to install the Adafruit NeoPixel library. 
This link gives you step-by-step instructions on how 
to do this: magpi.cc/inRSyYk. 


>STEP-04 
Finish off the tube 

Take a scrap CD or DVD with a good 
mirrored surface and use a disc sander 

to reduce its diameter so that it fits in the 
tube. At the very least, remove the clear 
band round the outside of the disc, as 

the mirror surface needs to be as close 

to the walls of the LED tube as possible. 
Cut another CD to make a patch to cover 
the hole in the CD, and use double-sided 
sticky tape to fix this to the base of the LED 
tube. Cut out a piece of black mounting 
foam to fit the picture frame; using a 
scalpel, cut a hole in the middle for the 
LED tube, allowing a bit of extra room to 
accommodate the LEDs sticking out. 
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INFINITY MIRROR 


2.1mm Power Jack 


680uF 


to oe oe ee = = = 


The software has a simple job: to take the 
distance measurement from the sensor and use 
it to trigger one of four animations on the LEDs. 
These patterns are written as a State machine, so 
that at each step there's an opportunity to check if 
the distance has changed or the shutdown button 
has been pressed. The time between each step is 
determined by the patternTimeSteps list and 
can be changed to alter the speed. In order to shut 
down the Pi Zero safely, there's a push button that 
triggers a shutdown — press this before removing 
the power supply. 


Not Connected 


Tutorial 


+5V 


dluls ‘0°41 


Data 


Fig 3 The schematic 


of the WS2812b 
LED driver 
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Tutorial WALKTHROUGH 


“= 


mirrorl.py 
>STEP-05 Q@1. # Magic mirror display 


Make the brackets Q@2. # By Mike Cook - January 2016 
Cover the picture frame glass with the mirror film. There are plenty of eo) 
online examples of how to do this using a squeegee, water spray, and QA. 
baby shampoo. Any specks of dust will show up, so make sure it’s well 
cleaned. Note that it will take about a week for the film's glue to cure 
and bond with the glass. Fit the tube and mount flush with the mirror 
in the frame, and use a fillet of hot-melt glue to fix the light tube to the 
mount. Make a bracket to hold the distance sensor with a small piece 
of asymmetric angle aluminium and paint it black. Fix it on the bottom 


import time, os, random 

Q@5. import wiringpi2 as io 

Q6. from neopixel import * 

07. 

Q8. random. seed() 

Q@9. DATA_PIN = 18 # pin connected to the NeoPixels 


of the frame with two M3 bolts. Use these same bolts to fix the bracket 10. NUM_PIXELS = 16 # number of LEDs in the spiral 

that holds the Pi Zero and electronic interface. Fix the Pi Zero to the iii 

bracket using nylon nuts - we used drilled-out nylon nuts to make 25) try: 

the stand-off pillars for the Zero to ensure there was no chance of the a3 io.wiringPiSetupGpio( ) 

GPIO plug shorting out on the bracket. 14. except : 

; 2 Peer a. on ) 15. print"start IDLE with ‘gksudo idle' from CLI" 

1G: os. _exit(1) 
gL 


18. pixels = Adafruit_NeoPixel ( 
NUM_PIXELS,DATA_PIN, 8900@0,5,False) 

LS. 

20. sensorPins = [17, 24,23, 27 | 

21. shutDownPin = 26 

22. pattern = 9 

23. patternTimeSteps = [@.5, 0.08, 0.05, 0.2, 0.01] 
# time spent in each step 

24. patternStep = @ ; patternTemp = @ ; 
patternTemp2 = @ 

25. col = | (255,0,0)))(0, 255,,0)., (0,6, 255), (255,255,255), 


>STEP-06 
Finishing off 
Finally, build the electronics — that is Fig 2 & 3 - ona small piece of We used a Pi B+ to develop the code using the 
stripboard. We used pin headers soldered horizontally to make the Pimoroni Black HAT Hack3R. When finished, we 
connections with the LEDs and the distance sensor. Cut holes in the back 
mounting board to fix the LED disc in place. 


changed the /etc/rc.local file to add this line to the end: 


python "path name"/mirrori1.py & 


This makes the Pi boot up automatically into this 
program. Of course, the ‘path name’ was replaced by 
the path where this program is to be found. This needs 
to be in quotes if there are any spaces in the path. 
Then we just swapped the SD card over to the Pi Zero 
and mounted it in the mirror. 


Taking it further 

You can experiment and write your own LED display 
patterns that are triggered for each of the four 
distances the mirror can detect. You can even make 


A the patterns multi-step — that is, the sequence of light 
. could be extended, and change the longer the viewer is 
\ at a fixed distance. 


' > 

+ In part 2 next issue, we will show you how to add 
a a time display to the mirror, but all is not quite as 

The mirror’s light patterns react to your proximity straightforward as you might think. Tune in next 

month for a bit of a surprise. 
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(255,0,0),(@,255,0), (0,@,255), (255,255,255) ] 


def main(): 
initGPIO() 
while True: 
if io.digitalRead(shutDownPin) == 
os.system("sudo shutdown -h now") 
# to prepare for power down 
checkForDistance() 
advancePattern() 
time.sleep(patternTimeSteps[ pattern] ) 


def advancePattern(): # next step in LED pattern 
global patternStep, patternTemp, patternTemp2 
if pattern == 
return # nothing to do 
if pattern == : # Radar scan 
if patternStep == 0: 
patternTemp +=1 
if patternTemp >3 : 
patternTemp = @ 
wipe() 
pixels.setPixelColor(patternStep, Color(col[ 


patternTemp][@],col[patternTemp][1],col[patternTemp ][2])) 


updateStep() 
return 
if pattern == : # Colour wipe 
if patternStep == 
patternTemp +=1 
if patternTemp >3 : 
patternTemp = @ 
pixels.setPixelColor(patternStep, Color ( 
col[patternTemp |[@],col[patternTemp][1],col[ 
patternTemp][2] )) 
updateStep() 
return 
if pattern == : # Multicolour riot 
wipe() 
off = patternStep & 90x@3 
for L in range(@,NUM_PIXELS,4): 
pixels.setPixelColor(L, Color( 
colporr ile | collomm (1s colilornil 2). 
pixels.setPixelColor(L+1, Color( 
col[off+1][0],col[off+1][1],col[off+1][2])) 
pixels.setPixelColor(L+2, Color( 
col[off+2][0], col[off+2][1],col[off+2][2])) 
pixels.setPixelColor(L+3, Color( 
col[off+3][0],col[off+3][1],col[off+3][2])) 
updateStep() 
return 
if pattern == : # Slow colour cycle 
= Q: 
patternTemp += 5 


if patternStep 


if patternTemp > 255: 
patternTemp = 0 
pixels.setPixelColor(patternStep, Hcol((( 
patternStep * 256 / NUM PIXELS) + patternTemp) & 255)) 
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INFINITY MIRROR 


updateStep() 
return 


>PYTHON 2.7 


DOWNLOAD: 
magpi.cc/1NqJjmV 


def initGPIO(): 
for pin in range (0,4): 
io.pinMode(sensorPins|[ pin], @) 


PROJECT 
VIDEOS 


io. pullUpDnControl( 
sensorPins[ pin], 2) 


Check out Mike's 
Bakery videos at: 
magpi.cc/1NqJnTz 


io.pinMode(shutDownPin, @)#input 

io. pullUpDnControl ( 
shutDownPin, 2) 

pixels.begin() 

# This initialises the NeoPixel library 


def updateStep(): 
global patternStep 
patternStep +=1 
if patternStep >= NUM _PIXELS : 
patternStep =0 
pixels. show() 


def wipe(): 
for i in range(@,pixels.numPixels()): 
pixels.setPixelColor(i, Color(@,0,0)) 


def Hcol(h): # HSV colour space with S = V=1 
def il << eo, 
return Color({h * 3, 255 = h * 3, 9) 
elit hi < 170: 


h -= 85 

return Color(255 —- h * 3, 6, h * 3) 
else: 

h -= 170 


return Color(®, I * 3; 255 = h * 3) 


def checkForDistance(): # select pattern based on distance 


global pattern, patternStep 
if io.digitalRead(sensorPins[0]) == 
if pattern != @: # if something showing 
wipe() 
pixels.show() 
pattern = 0 # stop any display 
patternStep = @ # put to start of a pattern 
else : 
close = @ 
for n in range(1,4): 
if io.digitalRead(sensorPins[n]) == 
close =n 
if pattern != close+1 : # has pattern changed? 
pattern = close+1 
patternStep = @ # stage in pattern 
#print"now showing pattern",pattern 


# Main program logic 
if name == '_main_': 
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Tutorial 


Adiscarded globe froma 
charity shop is the perfect 
thing to create the wake-light 


> Sense HAT 
magpi.cc/ 
aTGGUt5 


> BlinkyTape 
LED strip 
(or NeoPixel / 
DotStar) 


> An unwanted 
globe 


> Plastic bottle 


> Sticky pads 


> Blu-Tack 
or putty 


The main light for the alarm 
is much brighter than the 
Sense HAT LEDs 


JAMES SINGLETON 


James is a developer, engineer, 
and author. He helps people find 

_ software jobs in the environmental 
sector with ‘Cleanweb Jobs’. 
unop.uk 

cleanwebjobs.com 


It's all powered by the 
Raspberry Pi, timed to go 
off when you need it to 


‘aoe oe 


THE PI-POWERED 
WAKE-LIGHT 


Turn a globe into a glowing orb and use it to help you wake up 


in the dark winter months 


uring the winter, or even at any time of 

the year, it can be difficult to get up in the 

mornings. If you wake before dawn, your 
body still thinks it’s night (because it is). You can 
buy wake-lights that trick your body into waking 
up by simulating a fake sunrise; they get gradually 
brighter as your alarm approaches. These can be quite 
expensive, so why not make your own with a Pi and 
some LEDs? To celebrate the Astro Pis on the ISS, 
we’ve built one using a Sense HAT inside a globe that 
was found in a charity shop — perhaps an unwanted 
Christmas present, now repurposed! 


62 | MdgPi March 2016 


Make an LED bulb 

Create a bulb by wrapping an LED strip arounda 
plastic bottle. You could skip this, but the Sense HAT 
is not bright enough to make a lamp. Cut the top off 
an empty plastic bottle, cover it in sticky pads and 
wrap the LED strip around it in a spiral. You can secure 
the ends further with tape. Have the connection end 
at the wider opening so that you can route the power 
cable to the Pi and then out through the centre. We’1l 
mount the Pi on top of the upside-down bottle end, 
so ensure it's flat. 
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>STEP-02 

Destroy the world 

Remove the Earth from its mount by pulling the 
pegs of the holder out of the holes in the Arctic 
and Antarctic. Next, split it in half along the equator 
by pulling the two hemispheres apart. It should 
disassemble fairly easily with a little force applied 
in the correct places. You’ll want to fashion a new 
mount to stop the globe rolling around, whilst still 
allowing the power cable to exit from the bottom 
hole - you could use the inside of a roll of tape. 
You can cut a small slot with a knife to allow 

the wire to enter. 


>STEP-03 


Mount inside globe 

Attach your new LED bulb to the inside of the globe. 
Mount the neck of the bottle over the lower hole 

with Blu-Tack or putty; it should be sturdy enough 

to support the weight of the Pi resting on top of it. 
Mount the Sense HAT on the Pi, and then place both 
on top of the upturned bottle. Attach a USB WiFi 
dongle to the Pi (unless you’re using wired Ethernet), 
otherwise it will wake you at the wrong time. This is 
because the Pi requires internet access to set its clock. 


>STEP-04 

Route the power 

You’ll probably need to cut and reconnect the 

power cable to fit it through the hole. The official 

Pi power supply uses bell wire, which makes it easy 
to reconnect with a screw terminal (choc block). 
Unfortunately, it doesn’t supply enough power to use 
the LEDs at full brightness and also run the Pi. Cut 
the cable and insert the supply end through the hole. 
Tie a knot in the cable to stop it from being pulled 
back through. Separate the two power cores from 
both ends and strip the insulation. Reconnect with 

a choc block, matching the polarity. 


>STEP-05 
Download the code 


Clone the code from the GitHub repository into your 
home folder: 


git clone https://github.com/jpsingleton/ 
pi-glowbe.git 


If you’re only using part of the hardware or 
a different LED strip, you can adapt the code 
to your needs. You may also need to install the 
Sense HAT software if you’re running an older version 
of Raspbian — follow the instructions at 
magpi.cc/1KboHnN. You may also want to disable 
the LEDs on the Pi so they don’t disturb your sleep. 
Newer models can do this in software, otherwise you 
could tape over them, or even de-solder them if you’re 
brave enough. 
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P! GLOWBE 


qanguage 


wakeup.py 

>PYTHON 2.7 
from BlinkyTape import BlinkyTape 
from sense hat import SenseHat 
from time import sleep 


import optparse 


DOWNLOAD: 
magpi.cc/1TUKdz7 


Tutorial 


# Default Blinky Tape port on Raspberry Pi is /dev/ttyACM@ 


parser = optparse.OptionParser() 
parser.add_ option("-p", "--port", dest="portname", 


help="serial port (ex: /dev/ttyACMe)", 


default="/dev/ttyACMe" ) 
(options, args) = parser.parse_ args() 


if options.portname is not None: 
port = options.portname 

else: 
print "Usage: python wakeup.py -p <port name>" 
print "(ex.: python wakeup.py -p /dev/ttyACM@)" 


exit() 
sense = SenseHat() 
bt = BlinkyTape(port) 


# wake phase - gradually get brighter, linearly 
SleepTime = 18 # 18 sec for 30 min in 10@ steps 
maxPower = 100 # flickers or cuts out above 100 


for y in xrange(maxPower) : 
sense.clear(y * 2, y * 2, y * 2) 
for x in xrange(sleepTime): 
bt.displayColor(y, y, y) 
sleep(1) 


# on phase - at full brightness for the same time 

sense.clear(255, 255, 255) 

for z in xrange(maxPower * sleepTime): 
bt.displayColor(maxPower, maxPower, maxPower) 
sleep(1) 


# tidy up 
sense.clear() 


>STEP-06 

Set up your schedule 

We’ ll run the code with cron. It should start about half an 
hour before you get up and probably only on weekdays. 
Launch the cron configuration by typing the following 
into a terminal: 


crontab -e 
Next, set it up by adding the following line to the end: 


15 6 * * 1-5 python /home/pi/pi-glowbe/ 
wakeup. py 


This will run the code every weekday at 06:15, so change 
it to meet your needs. Save the file and exit the editor 
(CTRL+X, Y, then ENTER in the default nano). Once 
happy, reassemble everything and wait for morning! 
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OZZY HAYLER-GOODALL 


When Ozzy is not coding experiments 
© forthe ISS, he's playing rugby or being 
a junior mentor at CoderDojo Ham. 
He's nine years old. 
CoderDojoHam.org 


The roof stops you looking down 
and seeing where the bedrock’'s 
shadow is 


Try not to fall down those 
holes on the way! 


Here's the timer - you have 
80 seconds to get to the 
other side in our version 


THE BEDROCK 


How good is your intuition? Can you navigate your way through an invisible arena? 


magine you’ re building your house in Minecraft, You can’t cheat by jumping or flying because if you do, 
minding your own business, when suddenly you get teleported back to the start. The only help you 
you’re teleported high in the air. You’re get is an LED which will light up if there’s a hole in any 
forced to compete in the Bedrock Challenge. If you of the nine blocks around you, but not the one you’re on. 
fail to get to the other side of the arena, you plummet We use the Python library PyAutoGUI, which can 
to your doom! Have a go at coding your own Bedrock cause a key to be pressed down or released. We also 
> Jumper wires Challenge, see if your friends can complete it, andhave — use another library called ‘threading’, which lets 
Serendiccrd a go yourself. us run something while other parts of the program 
aE The Bedrock Challenge is a game where the goal is are working. Other libraries are used, but we don’t 
ae to get to the other side of the invisible bedrock grid have to install them because they are standard 
without falling down the holes. The catch is that Python libraries. 
there’s a wooden roof so you can’t see the light shining 
through the holes onto the ground, where invisible Get prepared 
bedrock would cast a shadow. Here’s how you install PyAutoGUI. Open a terminal and 


type the following into it: 

Here's the 
circuit that lights 
up the LED. It's 
very simple, only 
requiring an LED 
and a resistor 


sudo pip3 install pyautogui 

Next, install threading: 

sudo pip3 install threading 

Finally, python3~-xlib, as required by PyAutoGUI: 
sudo apt-get install python3-xlib 


Now we’re on to the wiring: you need to connect the 
LED to the Raspberry Pi. Build the circuit as shown in 
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bedrockchallenge.py 


from gpiozero import LED 
from mcpi.minecraft import Minecraft 
import time, sys, random, threading 
import pyautogui as pag 
led = LED(13) 
mc = Minecraft.create() 
running = True 
def make_holes(num, x, y, z): # make the holes 
for I in range(num): 
rx = random.randint(2,49) 
rz = random.randint(2,49) 
mc.setBlocks(x+rx, y+20, Z+rz, x+rx, y+22, z4+rz, QO) 
def monitor(starting pos): 
global running 
HED = (Gdiaats |) - -1, Oe) (1 1-15 
@, -1, =a) (1, =i, =i): (1, =i, Q), (1, =i, 1), (9, =i, 1)] 
y_start = starting pos.y 
while running: 
pag.keyUp( ‘shift’ ) 
pos = mc.player.getTilePos() 
for p in LED: 
boss = mc.getBlock(pos.x+p[@], pos.y+p[1], pos.z+p[2]) 
if boss==0: 
led.on() # LED on 
else: 
led.off() # LED off 
if pos.y > y_start: 
mc.postToChat (‘cheat’) 
mc.player.setPos( 
starting pos.x, pos.y, starting pos.z) # teleport after cheating 
time.sleep(1) 
if pos.y < y_start: 
mc.postToChat (‘Uh-oh’) 
time.sleep(3) 
mc.player.setPos( 
starting pos.x, starting _pos.y, starting pos.z) 
# move after cheating 
if pos.z==starting pos.z+51: 
mc.postToChat('Well Done’) 


Fig 1. To test it, open a terminal and type python3, 
then enter the following lines: 


Tutorial 
qanguage 


>PYTHON 3 


THE BEDROCK CHALLENGE 


running = False 
EY. 
pos = mc.player.getTilePos() 
mc .postToChat ( 
‘get ready for the bedrock challenge’ ) 
time.sleep(1) 
mc .postToChat ( 
‘get to the other side without falling 
down the holes!') 
time.sleep(3) 
mc.setBlocks( 
pos.x+1, pos.y+2@, pos.zZ, pos.x+53, pos.y+22, pos.z+53, 35) #wool 
mc.setBlocks( 
pos.x+2, poS.y+20, pos.zZ+1, pos.x+52, pos.y+20, pos.z+52, 95)#bedrock 
mc.setBlocks( 
pos.x+1, pos.y+3@, pos.Z, pos.x+53, pos.y+30, pos.z+53, 17) #roof 
mc.setBlocks( 
pos.x+2, poS.y+21, pos.z+1, pos.x+52, pos.y+22, pos.z+52, Q@) 
# air for Steve starting position 
mc.setBlocks( 
pos.x+25, posS.y+21, pos.z+1, pos.x+25, pos.y+22, pos.z+1, Q) 
mc.player.setPos( 
pos.x+25, pos.y+21, pos.z+1) # teleport to start 
newpos = mc.player.getTilePos() # get new position 
t1 = threading.Thread(target = monitor, args = (newpos, )) 
ti.start() 
make _holes(25@, pos.x, pos.y, pos.z) 
time start = time.time() 
counter = 8@ # setting the timer 
while time.time()<time_start+80: # starting the timer 
time.sleep(1) 
counter -=1 
if counter%10==0: 
mc.postToChat(str(counter) ) 
mc.setBlocks( 
pos.x+2, pos.y+2@, pos.z+1, pos.x+52, pos.y+2@, pos.z+52, Q) 
mc.postToChat('GAME OVER") 
running = False 
except Keyboardinterrupt: # type Ctr1+C 
print('bye' ) 
running = False 
sys.exit() 


DOWNLOAD: 
magpi.cc/1QbdoYO 


around the perimeter walls. The function that stops 
you cheating has another purpose: it turns the LED 


on if there’s air around you. We do this by finding the 


from gpiozero import LED 
led = LED(13) 
led.on() 


positions of all nine blocks, then we see if one of them 
is air. If one or more is air, we turn the LED on. If you 
do sadly fall down a hole, ‘Uh-Oh’ gets displayed and 


you'll be teleported back to the start. 


This should turn on the LED assigned to GPIO pin 13. 


Here’s how we create the arena. We first build 


the invisible bedrock plane, then we pick random 


Modding Minecraft 

Now we’ ve done all our preparations, let’s get coding! 
In this code, we have two functions: one stops you 
cheating while the other creates the holes. There 

are two main ways of cheating, and we block both of 
these. One way is to hold down the SHIFT key (‘enable 
sneak’), which normally stops you falling. We use 
PyAutoGUI to hold the SHIFT Key up to prevent you 
from using sneak. The other way is to fly to the finish. 
We stop this by finding your Y position at the start, 
then checking if it has changed - in other words, if 
you’ve gone higher. It also won’t allow you to run 
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positions to place the holes. After that, we build the 
roof, and then finally we create the wool walls. To 
give you a time limit to reach the other end we have 

a counter, which gets displayed on the Minecraft 
screen when it reaches a multiple of ten. When it 
reaches zero, we turn all the invisible bedrock into air. 
Game over! 

You could make it easier by giving the player more 
time, or make it harder and have more holes. If you 
have an annoying older brother, they might find some 
other sneaky ways to cheat. Can you think of any? If 
you can, try to write code to prevent them! 
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Tutorial WALKTHROUGH 


RICHARD HAYLER 


“Richard is a mentor at CoderDojo Ham. His 
school Code Club was one of the winning 

- teams in the Primary Astro Pi competition 
» who now have their code on the ISS. 
richardhayler.blogspot.co.uk 
@rdhayler / coderdojoham.org 


Under white light, the Lego 
blocks look red, just as we 
normally see them 


Remove the red component 
from the light and the blocks 
appear black, because 

there is no Longer any light 
scattered from them 


Use the HATColourSlider 
widget to gradually change 
the light colour in your box 


SENSE 


HAT SCIENCE: 


Why is grass green? Why do we see objects as having different colours? 
With your trusty Sense HAT, you can carry out a simple experiment to 
investigate the properties of light and colour 


aspberry Pi isn’t just about coding and 

learning programming languages. By 

attaching additional hardware, the Pi can act 
as a platform for all sorts of scientific investigations. 
The best example of this is the Sense HAT. This 
fantastic device is bristling with sensors, perfect for 
performing fun science experiments in the classroom, 
at home, or even on your orbiting space station. In 
this first Sense HAT Science feature, we’re going 
to look at the LED matrix and some simple ways of 
demonstrating the ideas of a colour spectrum of light, 
and why different objects are different colours. 


> A Sense HAT 
(or a Unicorn HAT) 
magpi.cc/ 
1TGGUt5 
(or magpi.cc/ 
4PCpRZ5) 


> An old cereal 
box, scissors 
and sticky tape 


> HATColourSlider 
magpi.cc/ 
10kQVCt 


THE ELECTROMAGNETIC SPECTRUM 


> Some small 
objects of 
different colours 
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Programming the lights 

The LED matrix on the Sense HAT has 64 elements 
made up of three separate LEDs - red, green, and blue 
- inasingle housing. We can illustrate this in Python. 
Open IDLE3, load the SenseHat library and connect 

to the board: 


from sense_hat import SenseHat 
sh = SenseHat() 


We can turn on all the LEDS with a single command: 
sh.clear(255,0,@) 


The three numbers in the brackets of the command 
represent the brightness of the three colours (in the 
order R, G, B and with 255 being maximum intensity), 
so this should switch on all the red LEDs but leave 
the green and blue ones off. To turn on just the green 
LEDs, type: 
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Blue LED 
460 - 480nm 


SENSE HAT SCIENCE 


Green LED 
52 - 540nm 


Tutorial 


Red LED 
619 - 624nm 


400 


sh.clear(@,255,@) 


You can do this in Scratch, too - see Fig 1 below. 
We can also mix colours to create other shades, 
much like paint: 


sh.clear(175,100, 200) 


This should produce a pleasant pale pink colour. You 
can do the same thing using Scratch, but you have to 
use hexadecimal notation to specify the colour values 
(Fig 1 again). 

To make it easier to quickly mix the colour settings 
for the Sense HAT LEDs, you can download a simple 
widget. Back in a terminal window, type: 


git clone https://github.com/topshed/ 
HATColourSlider. git 


Then change into the newly cloned directory and 
copy the desktop shortcut into place: 


cd HATColourSlider 
cp HATColourSlider.desktop ~/Desktop 


Double-click on the icon that will have appeared on 
your desktop and use the sliders to mix the red, green, 
and blue light. 

If you turn all three colours to their maximum, you 
should see that the LEDs produce white light. 


For science! 

Back in 1665, Isaac Newton was the first to prove that 
white light is made up of all the colours that we can 
see: he took a glass prism and placed it ina sunbeam, 
producing a spectacular multicoloured spectrum like 
a rainbow. Light waves are refracted as they enter 
and exit the prism. The shorter the wavelength of 
the light, the more it is refracted. As a result, red 
light is refracted the least and violet light is refracted 
the most, causing the coloured light to spread out 

to form a spectrum. We can think of the LEDs in the 
Sense HAT as performing this process in reverse — 
combining the colours to produce white light. 

We can also use the Sense HAT’s ability to produce 
different-coloured light to investigate why objects 
appear as different shades. Find a box big enough 
to hold the Raspberry Pi and Sense Hat, and which 
has a top that you can close. Half a cereal box is 
an ideal size for this purpose: cut a slot along one 
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Wavelength in nm 


corner to allow the power and HDMI cables to remain 
connected. Now find a bunch of small, different- 
coloured objects that will fit in the box (Lego 

blocks are perfect). Make sure you have red, green, 
and blue objects. 

This works best in a dark room; close the flaps on 
the top of the box to prevent as much external light 
as possible entering from the monitor, while leaving 
a small gap that you can peer through. 

Start with a red object. Illuminate it in the box 
with all LEDs set to maximum (i.e. white light). 

Now reduce the brightness of the red LEDs down to 
zero. The ‘redness’ of the block should fade until it 
appears black. Try the same experiment with blue 
and green coloured objects, observing what happens 
when you remove that colour from the light emitted 
by the LEDs. 


Conclusive evidence 
Why does this happen? An object appears to have 
a colour because it is able to selectively absorb and 
reflect certain wavelengths of visible light. An object 
will appear white if it does not absorb any wavelength 
of visible light and all the light that falls upon it is 
scattered back to our eyes. An object will have a red 
colour when it absorbs all wavelengths of visible 
light except for red. Just the red light is scattered 
to our eye, so the object looks red. However, as you 
can demonstrate with the Sense HAT, if we remove 
the red component of white light that falls on a red 
object, there is nothing to be scattered back and so 
the object will appear black. From this we can also see 
that a black object will therefore be one which absorbs 
all the wavelengths of the light falling on it. 

So what about grass° Like many plants, it produces 
a bright pigment called chlorophyll which absorbs 
blue and red light well, but mostly reflects green light. 
Now you know! 


clicked 


5) SenseHAT 


broadcast gpioserveron 


when when ° 
set Addon 


broadcast clearleds 


when 9 key pressed when P 


broadcast ledbackqroundareen 


broadcast clearleds 


key pressed 


700 


Above Each colour 
LED produces light 
at a small range of 
wavelengths. The 
closer in colour 

an object is to 

this wavelength, 
the ‘blacker’ it 

will appear when 
that component 

is removed 


HEXADECIMAL 


Hexadecimal 

is a base 16 
number system. 
A hex digit can 
be any of the 


following 16 
digits:012 3 
456789AB 
CDEF.S0175 
is OxAF, 100 is 
0x64, and 200 
is OxC8. 


Fig 1 If you 

want to specify 
exotic colour 
combinations in 
Scratch, you need 
to use hex notation 


broadcast ledbackgroundred 


key pressed 
broadcast ledbackground#8664c8 


broadcast clearleds 
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YOUR QUESTIONS ANSWERED 


NEED A 
PROBLEM 


SOLVED? 
A 5 K E D Q U E S T | 6 N 5 iets 


to feature in a future issue. 


WHAT'S THE BEST NORMAL I'M HAVING PROBLEMS UPDATING 
OPERATING SYSTEM? RASPBIAN 
Raspbian Fill the SD card 
The official operating system for the Raspberry Pi is From the configuration menu for Raspbian, there’s 
made to be easy to use and comes with a lot of tools an option to expand the file system to fill the SD card. 
for teaching and learning. It supports all the hardware _ If you’re running out of space from the basic image, 
functions of the Raspberry Pi first, and usually by you may not be able to download updates properly 
default as well. to install them. This will generally fix it. 
Ubuntu MATE Disable software sources 
Based on the wildly popular Linux distribution Ubuntu, —_If you notice the Raspberry Pi hanging on specific 
Ubuntu MATE uses the MATE desktop environment packages while updating and can’t wait, you may need 
on top of an optimised version of Ubuntu for the to go into the Software Sources list and disable that 
Raspberry Pi. If you’re looking for a pure desktop specific repository and then run the update again. 
experience, Ubuntu MATE is worth a look. It will skip the troublesome packages. 
Arch Linux Reinstall 
A very small operating system that comes with the Unfortunately, if it’s just not updating or working 
bare-bones to get the Raspberry Pi running. If you properly, you may just need to reinstall Raspbian to the 
need a lightweight, quick OS that makes the most SD card, possibly because it didn’t install properly in the 
of the Raspberry Pi’s power and don’t mind working first place. Re-download the image or NOOBS version 
in the command line, this is the one for you. you’re using, back up any data on the card, and try again. 


WHAT OPERATING SYSTEM IS GOOD FOR 


MEDIA CENTRES? 


OpenELEC 

OpenELEC runs Kodi, which used to be called XBMC, 
and is heavily optimised to be fast on anything it runs 
on. If you want the pure Kodi experience and just a 
decent, low-hassle HTPC, OpenELEC is an excellent 
choice to help get you started. 


Recently added movies 


OSMC 

While OSMC uses Kodi as a base, it has its own interface 
and extra features added on top to make it a little 
different, and in some ways a bit more user-friendly. 

It also installs very easily and quickly. 


Raspbian + Kodi 

Installing Kodi on Raspbian is a great way to havea 

multipurpose Raspberry Pi. It won’t run as well as 
$I OpenELEC or even OSMC, but you can switch between 

Fe > omen mee = S HTPC mode and normal desktop mode. 
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What system on a chip is used in the Raspberry Pi? 

All versions and revisions of the Raspberry Pi other 
than the Raspberry Pi 2B and 3B use the Broadcom 
BCM2835. This contains an ARM1176JZF-S with floating 
point, running at ZOOMHz, and a VideoCore IV GPU. 

The GPU is capable of Blu-ray-quality playback, using 
H.264 at 40Mbps. It has a fast 3D core, accessed using 
the supplied OpenGL ES2.0 and OpenVG libraries. 

The Model 2B uses the Broadcom BCM2836. This 
contains a quad-core ARM Cortex-A7 processor with 
floating point and NEON, running at QOOMH7z, and the 
same VideoCore IV GPU that is in the other models of 
Raspberry Pi. The Model 3B uses a Broadcom BCM2837, 
which again is a quad-core processor, although this one 
is based on the 64-bit ARM Cortex-A53 and clocks at 
1.2GHz per core. It too has a VideoCore IV GPU. 


The best Raspberry Pi products and. accessories, all under one roof with low cost UK shipping 


Twitter: 
Email: 
Tel: 


YOUR QUESTIONS ANSWERED 


What is a system on a chip? 

A system ona chip (SoC) is a method of placing all 
necessary electronics for running a computer on a single 
chip. Instead of having an individual chip for the CPU, 
GPU, USB controller, RAM, Northbridge, Southbridge, etc., 
everything is compressed down into one tidy package. 


Why did you select the ARM1176JZFS? 
Cost and performance. 


Do you make a self-assembly kit of the Raspberry Pi? 

No. It would be too expensive for us to provide kits alongside 
finished boards, which would mean introducing another step 
in manufacturing; and a kit would be impossible to hand- 
solder. We use special equipment (robots!) to solder on the 
BGA package and other tiny components. 


@ThePiShack 
info@pi-shack.com 
+44 7413 039894 
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irst comes the urge to make, strong enough to 
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. get you past sensor glitches, Pi peculiarities, 
Slee Ula nd -keep guide On) and nearly untraceable software bugs. As your 
how (and why) you should give project’s smart-looking case comes together with an 


almost-functioning prototype, then comes the urge 


your next Raspberry Pi project to share. Carried by the feelings of joy and satisfaction 


an open- source lice nce that accompany a successful build, you even make a 
_ decent stab at documentation; time to publish online 


somewhere. Hold on, there’s something we haven’t 
thought about yet: the licence. 

In most countries since the Berne Convention of 
1886, publishing anything — including software — will 
automatically put it under copyright, preventing 
anyone from redistributing it without permission. 
Open-source licences are designed to make it easy 
to share your software and hardware with the 
community of makers, allowing other people to 
have fun building your project, then maybe adding 
their own modifications and putting them online for 
others to build on — derivative works, in licensing 
speak — and giving you back a few ideas for the next 
iteration. The situation with hardware is nowhere 
near as straightforward as software, and we’ll get 
onto that later, as well as a few things to bear in mind 
when licensing documentation, but first, let’s look 
at software licences. 

The open-source world thrives on choice, yet the 
number of licences available is bafflingly huge —- 70 on 
the OSI-approved list alone. The historic reasons for this 
are long and vexed (see ‘Free or Open®’ boxout), but the 
choices are simpler than they seem, and come down to 
a Straightforward question: when somebody modifies 
your design and makes those changes available in some 
product or design form, would you like them to share 
those modifications with the community in the same 
way that you have, or would you like them to be free to 
do what they want — even Keeping changes secret, and 
selling the results? 
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Free to share 
Enforcing sharing through licences is known as 
copyleft, and the best-known copyleft licence is the 
GNU GPL - used for much of Raspbian and all of its 
other GNU/Linux relatives. The GNU General Public 
License (GPL) is one of the oldest FOSS licences, and 
was the first designed to ensure both the freedom of 
the end user and that of users further down the chain, 
after software had been modified and passed on. 
The Free Software Foundation (FSF) and the GNU 
project were both started in the 1980s by Richard 
Stallman, who wrote GNU Emacs and the GNU 
toolchain, including the GNU Compiler Collection’s 
(GCC) € compiler, which is the first piece of 
software that chip manufacturers port to any new 


Enforcing sharing 
through licences 1s 
) known as copyleft 


hardware platform. While the GNU project - at 

least with the addition of the Linux kernel - has 
erown to dominate every area of serious computing, 
the copyleft ideas behind the GPL have had an 

effect in several fields beyond computing — from 
farming (opensourceecology.org) to medicine 
(opensource.com/tags/medicine). The key to copyleft 
is protecting ‘four essential freedoms’: 


The freedom to run the program as you wish, 
for any purpose (freedom 0). 


The freedom to study how the program works, 
and change it so it does your computing as you 
wish (freedom 1). Access to the source code 

is a precondition for this. 


The freedom to redistribute copies so you can 
help your neighbour (freedom 2). 


> The freedom to distribute copies of your 
modified versions to others (freedom 3). By 
doing this, you can give the whole community 
a chance to benefit from your changes. Access 
to the source code is a precondition for this. 


All of this can be summarised as ‘I’m going to let 
you do what you like with my program — providing 
that when you pass it along (with or without your 
own modifications), you pass on these same freedoms 
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FREE OR OPEN? 


English, despite its monstrously large vocabulary, 
is one of the only languages to conflate the 
meanings of free-of-charge and free-as-in- 
speech into the same word. Consequently, free 
software in the early days was often lumped 

with freeware, shareware, and other proprietary 
but often amateur small projects. The approach 
of the Free Software Foundation (FSF) to this 
problem (for the English-speaking world) is to talk 
continuously about freedom until the message 
gets through. 

A different approach was taken by some 
members of the GNU/Linux community at the 
end of the 1990s, coining the term ‘open source’ 
in an effort to find a business-friendly alternative 
to ‘free’. Their early rhetoric tended to emphasise 
the benefits of access to the source code, which 
led to some muddying of the waters when some 
proprietary companies allowed limited access to 
their source code, but under very restrictive terms. 

The term FOSS (free and open-source software) 
nowadays means we can all talk about the same 
thing, without bickering about words. The Open 
Source Initiative's ‘Open Source Definition’ [1] 
(based on Bruce Perens's Debian Free Software 
Guidelines of 1997) emphasises freedom to 
modify and redistribute every bit as much as the 
Free Software Definition [2] written for the FSF by 
Richard Stallman 30 years ago. 


> gnu.org/philosophy/free-sw.html 
> opensource.org/osd 
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CC BY 4.0 farmbot.io 


CASE STUDY 


FarmBot takes tender care of your 
plants - and great docs mean 
almost anyone can build one. 


BARLEY AND BEER — 


Licence choice is in part governed by what you want end users to 
do with your project - and if you want them to be able to do just 
about anything, we have mentioned permissive licences in the main 
text already. To get the best take-up of your project, however, lots of 
great documentation is important. 

FarmBot (farmbot.io) is an “open-source CNC farming machine 
and software package built for small scale, hyper-local, DIY food 


Manage the growing 
of plants over a one to 


20 square metre area 


production,” controlled by an internet-connected Raspberry Pi 

2 and Arduino/RAMPS (RepRap Arduino Mega Pololu Shield - 
popular for controlling 3D printers). As well as being a great project 
- using a CNC's XYZ motion, combined with specialist tools, to 
automatically manage the growing of plants over a 1 to 20 square 
metre area - the FarmBot project aims to be “not just open source 
[but] useful source.” 
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FARMBOT & BREWPI 


Useful source 

The plans are not just freely licensed, but include detailed assembly 
instructions, bills of low-cost and easily available materials, 
troubleshooting tips, past iterations, and exhaustive information on 
what FarmBot is all about. 

The intention is to soread FarmBot and its benefits far and wide: 
“we're even committed to operating our company with transparency 
and open company values at the forefront,” its creators say. As well 
as publishing all of the designs and software under free and open 
licences, FarmBot maintains a busy user forum with very good 
guidelines to help keep things civil. 


Contributing beer 
BrewPi (brewpi.com), another Raspberry Pi/Arduino hybrid, controls 
temperature in the brewing of beer (or fermentation of wine). A 
popular project, it's used by many suppliers of homebrew equipment, 
and to avoid potential problems, BrewPi has adopted a Contributor 
License Agreement (CLA) - similar to that used in the Django project 
- to ensure that all code contributed to the project can continue to be 
used and distributed with free and open licences. 

BrewPi's documents are available in reStructuredText format in 
the repository, as well as online. 
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to the next user.’ Copyleft licences like the GNU GPL 
have been behind the success of projects like the 
Linux kernel. This allows large computer companies 
to contribute, knowing that although they were 
‘giving away’ part of their knowledge, it would be 
shared in perpetuity by the community, not taken away 
and used to sole advantage by a competitor. é 
The GNU GPL is available in various ‘flavours’, but 
changes are made with great care. GPL version 2 was 
the standard for many years and is still used in the 
Linux kernel at the heart of Raspbian, Ubuntu, and 


The GNU GPL is 
available in 
various flavours’ 


many other operating systems found in everything 
from PVRs to supercomputers. GNU GPL v3 appeared 
26 years after version 2, with changes concerning 
threats to software freedom, particularly in relation 
to software patents, hardware restrictions on 
software modification, and digital rights management 
(DRM). It also made the GPL compatible with the 
Apache License v2.0. 

The GNU Affero GPL, or GNU AGPLv3 for short, is a 
version of the licence for software that is used over a 
computer network without being distributed - in other 
words, web apps. If you want a copyleft licence for the 
web-based controller software for your new Raspberry 
Pi project, this is a good choice. And speaking of choice, 
many people just want their software out there with no 
restriction on what happens next, and no worries about 
licence compatibility... 


Permissive 
Permissive licences like Apache, MIT, and BSD simply 
say ‘I’m going to let you do what you like with my 
program.’ There is no proviso; if you want to change 
the program then sell it, you don’t have to give your 
customers access to the source, or any freedom to 
run the software elsewhere or share it. Some people 
believe that this is more free, as it doesn’t restrict 
the immediate end user at all. Many hours have been 
spent in debate over which is the ‘better’ or ‘more 
free’ type of licence. Only one thing is certain: if 
you write some code, it’s yours, and you’re free to 
license it in any way you please — so choose what 
suits you best. 

One tiny but important thing to be aware of: your 
project may be built upon various libraries and, 
depending how closely they are coupled to your code, 
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Stallman, 
founder of the 
GNU project, 
wrote the 

first copyleft 
licence, the 
GNU GPL, in 


> 1986 to ensure 


software would 


“ always be 


free to share, 


‘4 improve, and 
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their licences may control your choice of licence for 
redistribution of the whole. The Lesser GPL (LGPL) 
is the FSF’s licence of choice for libraries, allowing 
dynamic linking even from proprietary (restricted) 
code. Naturally, permissively licensed libraries can be 
linked and redistributed much more freely. 

The Apache licence is about the best choice in 
permissive licences, as it offers some protection 
against vexatious patent litigation — a subject needing a 
separate article of its own. As incompatibility between 
licences is a real problem when trying to combine and 
redistribute software from different sources, Apache 
2.0’s compatibility with GPLv3 - and its patent clause 
— make it a good choice. The Apache License is also the 
preferred choice of the Python Software Foundation, 
for those whose code will be making its way into 
Python’s core libraries or the language itself. 
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COPYLEFT 


In 1984, GNU 
founder 
Richard 
Stallman 
received 

a letter 

from fellow 
programmer 
Don Hopkins, 
labelled 
‘Copyleft 

- all rights 
reversed’ The 
word seemed 
apt for the 
GNU GPL, and 
has been used 
ever since. 
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Hardware, hard to license 

We had a decade or two where, permissive vs. copyleft 
flame wars aside, things were relatively simple. 

Then along came the Internet of Things (IoT), cheap 
single-board computers, hobbyist projects, and side 
projects-turned-successful businesses; in other 
words, hardware arrived to muddy the licensing 
waters. Software is copyable at close to zero cost, 

and easily distributable around the world in seconds. 
Hardware needs to be fabricated, contains chips which 
may have their own licence terms, and comes with 
extra complications like firmware and proprietary 
codecs (such as the MPEG2 hardware decoder on 

the Pi). OpenCores, the community of open chip 
designers, distribute most of their designs as Verilog 
source files, licensed under the GNU LGPL. 


CC-BY-SA 3.0 Xeopesca, wikimedia.org 


74 | MdgPi March 2016 


Fortunately, for the average Raspberry Pi project, 
most are distributed as plans, simplifying licence 
considerations and leaving you free to spend time on 
getting the documentation right for the end users. 
Nevertheless, there are two hardware licences worth 
taking a look at. The TAPR Open Hardware License 
(tapr.org/ohl. html) was the first hardware-specific 
open-source licence, and came out of the amateur 
radio community. It references the GNU GPL, and 
differs in the crucial matter of tracking changes to 
original documentation. It also takes account of 
patents. The CERN Open Hardware License 
(magpi.cc/1QvYQmY), developed for CERN’s Open 
Hardware Repository, discusses ‘manufacture 
and distribution of Products’ and is popular with 
designers of open semiconductors. The difficulty is 
that although plans, instructions, and bills of parts 
are copyrightable as published works, copyright does 
not apply to the physical design and ideas that they 
contain. Legislation has yet to catch up with quick 
prototyping, additive manufacture (3D printing), 
and an open-source ethos in hardware. You should 
also consider the Solderpad License — Andrew 
Katz’s hardware-friendly re-rendering of Apache 
icemsery 2.0; 

It’s worth a quick read of the Open Source Hardware 
(OSHW) Definition 1.0 (oshwa.org/definition), again 
based upon Bruce Perens’s Debian Free Software 
Guidelines, covering rights to ‘study, modify, 
distribute, make, and sell the design or hardware 
based on that design’, and other documentation on 
the OSHWA (Open Source Hardware Association) 
website. The OSHW Definition calls for documentation 
to be released with the hardware, for much the same 
reasons that source code needs to be distributed to 
make software freely modifiable. 
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While open hardware has to cover everything 
from free and open 3D graphics chipsets to designs 
for laser-etched control panels, one thing they all 
have in common is the intention of the creator to 
share. And however dubious the current state of 
legislation around hardware, and thus the efficacy of 


the licences, adopting one of the two referenced above | 


clearly sets out your intention for derivative works, 
based upon your designs, to be made and shared: a 
commitment to the open hardware community. This 
is more important than the narrower considerations 
of copyleft vs permissive. 


Documentation 

Documentation is at the heart of any hardware project. 
One model is Creative Commons, devised to allow 
sharing of creative content, from photographs, through 
songs, to course materials. Wikipedia is dual-licensed 
under the Creative Commons Attribution-ShareAlike 
License — the share-alike clause being the copyleft part 
— and the GNU Free Documentation License (GFDL). 
Permissive versions are available, and CC’s ‘some 
rights reserved’ range of licences also extends to less 
free options, like those forbidding commercial use. 
This restriction is a real problem for social enterprises, 


Documentation 1s 
at the heart of any 
hardware project 


occasionally profitable side projects, and anything 
else that is ambiguously commercial. CC is also used 
for the millions of Scratch projects shared on MIT’s 
Scratch website — specifically, the Creative Commons 
Attribution-ShareAlike 2.0 (CC-BY-SA) licence. 
CC-BY-SA is also used for the design (CAD) files of the 
Arduino board. 

Documentation for a software project, in the early 
days of FOSS, was often redistributed under the same 
licence as the code. The problem is that although you 
want people to take your code and run with it - or, 
at least, you don’t object to them doing that, which 
is why you’re looking at open-source licensing - 
documentation should ideally have a certain stability. 
For example, you may have a wiring diagram in your 
docs which, if changed, could wreck some delicate 
electronics. The Free Software Foundation’s GNU Free 
Document License (FDL) requires changes to be logged, 
much like the TAPR Open Hardware License. 

As for the Raspberry Pi itself, despite the 
complexities of the various chips and their licences 
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Licensing your documentation enables it to be 
distributed, but spare a thought for how it will be 
read. PDFs aren't a bad choice as such, although 
they can be a pain on low-resolution screens. 
Plain text is responsive, flowing to fit any screen, 
but you have no control over appearance, and 
diagrams and images are a problem. 

The ideal solution would be to make available 
both online (HTML) documentation and 
downloadable (PDF) docs, but also source files to 
enable users to modify them and generate fresh 
documentation. TeX or LaTeX are still reasonably 
popular in parts of the tech community, but for 
the widest possible adoption and the ability to 
modify and improve the docs by interested users, 
Markdown is probably the best choice. 

With a shared repository for your 
documentation, perhaps using Git to allow easy 
branching, a tool like Pandoc which converts ably 
from Markdown or LaTeX to PDF, HTML, and other 
formats, and/or one of the great Markdown or 
reStructuredText (RST) format to HTML static blog 
producers like Pelican (the Python answer to the 
popular Jekyll), you can simplify and automate 
much of the work involved in managing the 
documentation, without the complexity (and pain) 
of conventional document publishing systems. 


and codecs in different versions, it’s a form of ‘ask 
nicely ware’. That is, back in 2012, in response to the 
successful beginnings of a Raspberry Pi ecosystem, the 
Foundation asked nicely if anyone was making a device 
requiring a Pi to work: “All we ask is that you include 
the words ‘Powered by Raspberry Pi’ somewhere on 
your packaging.” 

If all this decision-making seems a bit much when 
all you want to do is share your idea, think on this. Your 
act of sharing has the potential to reach millions of 
people. People in other countries, and other situations, 
who may take an element or two from your project and 
do something with it that you never even imagined. 
Surely all that potential deserves just a little of your 
time to make sure the licences are right, so you don’t 
stand in the way of someone else’s creativity? 
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EXTECH 
EX330 
MULTIMETER 


The EX330 

has all the 
features of the 
Proster VCg9, 
swapping only 
the transistor 
test mode for 
non-contact 
AC voltage 
detection, ina 
more compact 
package. 
Sadly, it’s also 
considerably 
more expensive. 


£47 / $60 
adafruit.com 
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PROSTER VC99 MULTIMETER 


PROSTER VC99Y 
MULITIMETER 


With everything a hobbyist could ask for, is the VC family 
of multimeters the bargain it appears to be? 


or years there was a 

eulf between affordable 
multimeters for the 
hobbyist and professional-grade 
hardware. Outgrowing a £10 
multimeter from a high-street 
electronics shop typically meant 
jumping to £100 or more for a pro 
device. More recently, though, 
Chinese multimeters have begun 
to give the big boys a serious 

run for their money without 
breaking the bank - devices like 
the Proster VC99. 

Part of the VC family and 
available from its original design 
manufacturer (ODM) under 
different brands, the Proster VC99 
is designed to give the hobbyist a 
wider range of functionality than 
your average pocket multimeter. 
The usual features are, of course, 
present and correct — there’s AC 
voltage sensing up to 1,000V and DC 
up to 700V, current measurement 


up to 20A for a maximum of ten 
seconds, capacitance measurement, 
and resistance measurement 

with visual and audible continuity 
test modes. But the VC99 really 
packs out the extras list: there’s a 
frequency counter mode suitable 
for measuring up to 60MHz with 

a +0.5% accuracy, a temperature 
sensing mode with bundled K-type 
temperature probe, and a current 
gain test (AFE) for PNP and NPN 
transistors through a built-in 
multi-pole socket. For anyone who 
has ever bought a multimeter with 
an hFE mode plug-in adapter, only 
to lose said adapter shortly after 
purchase, that feature alone is 
worth the asking price. 


Paying for quality 
Naturally, there are reasons why 
the Proster VC99 doesn’t cost twice 
the price. Chief among these is its 
accuracy: while the base accuracy 


of +0.5% compares well with even 
expensive multimeters, the +3.5% 
accuracy rating for capacitance 
measurement is decidedly less 
impressive. The screen, while large 
and easy to read in most conditions, 
is not back-lit, and the kickstand 
to the rear of the chassis is only 
capable of holding the multimeter 
at one rather shallow angle. 
Surprisingly, the VC99 doesn’t 
cut every corner. Included with 
the multimeter is a handy zipped 
storage bag, while the anti-shock 
rubber around the outside of the 
chassis includes storage mounts 
for the probes. These are worth 
mentioning, too: compared to 
similarly priced rivals, the probes 
included with the VC99 are of a 
surprisingly high quality. Unless 
you need something specific, like 
probes ending in test hooks, you’re 
unlikely to be looking to upgrade 
any time soon. 
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Essential features 
When setting the VC99 up for 
measurement, it’s easy to forget 
that it’s a budget multimeter. 
The probes sit securely in their 
ports, and the mode dial switches 
with a pleasingly tactile click. 
Buttons are included just below 
the display for various functions, 
including the ability to switch 
between frequency and duty cycle 
measurement - handy for testing Pi 
projects which use software-driven 
pulse-width modulation - and for 
enabling recording of maximum 
and minimum readings. There’s 
also a button to enable relative 
measurements to be taken: when 
measuring resistance, for example, 
this can be used to automatically 
subtract the resistance of the 
test probes themselves from the 
displayed figure. 

What you don’t get for the low 
purchase price is any sign of a 
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calibration certificate. While the 
measurements on our test unit 
proved accurate against calibrated 
hardware, there’s no guarantee 
the next model off the production 
line will be as well-calibrated. 

It’s possible to remove the casing 
from the multimeter and calibrate 
manually by adjusting on-board 
potentiometers, should you have 
access to calibrated hardware 
against which to compare 
measurements, but doing so will 
invalidate any warranty you may 
have had. 


A tough read 

The only other bone of contention 
with the Proster VC99 is the bundled 
manual. Small and confusingly 
written, it provides most of the 
information you could need to get 
the best from the device, but not 

in the most accessible manner. 
Signs of poor translation are also 
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present, including on the face of 
the multimeter where its ability 
to power off automatically after 
15 minutes of inactivity is proudly 
emblazoned as ‘AUTO OFF POWER’. 
These are minor niggles. While not 
every hobbyist will need anything 
more feature-packed than your 
average pocket multimeter, those 
who do will find the VC99 more 
than up to the job. Anyone working 
in an ill-lit environment, though, 
would do well to spend any money 
saved on a lamp to make up for 
the lack of illumination on the 
multimeter’s display. 


While its accuracy is definitely more suited to the 
hobbyist than the professional, the Proster VC99 
multimeter offers a wealth of functionality 


KKK K 


at a pocket-friendly price. 
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ZEBRA ZERO CASE 


Maker 
says 
The 

ultimate 

protection 
for your new 


little friend! 
C4 Labs 


ZEBRA 


ZERO 
CASE 


A case for the Raspberry Pi Zero that you can also get with a wooden 
finish. Is it practical or more for the aesthetics? 


ases for the Raspberry Pi 
Zero have been fairly quick 
to market: by the time 

The MagPi issue 41 was released, 
there was already at least one 

to get your hands on, and more 
have been popping up since. This 
may be because of the popularity 


NUCLEUS of the laser-cut acrylic sheets 

ZERO CASE that Pimoroni has promoted — 

eee = either way, it has created a small 

case: this one 

Has more market of cases made with a more 

wooden layers interesting material: wood. 

and amore — One of the first of these was 

abstract design. oo, 

sles GENES C4 Labs with its Zebra Zero case. 
It comes in both a wood-finish 


the GPIO pins. 


version and a normal clear acrylic 
one, so you have your choice of 

w style. However, even the wood- 
finish case isn’t fully wooden: 

a pair of ABS-plastic spacers 
separate the two wooden plates 

at either end. This is much more 
cost-effective while still achieving 


£5 /S$7 
magpi.cc/1KWsFAF 
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the overall effect. The wood is also 
laser-cut, so it’s nice and smooth. 
Each important port is uncovered 
and labelled via etching into the 
wood panel. It’s simple, neat, and it 
works well. The GPIO is completely 
uncovered, which, while making 
the Pi Zero seem a little naked at 
first, does make a lot more sense 
when a GPIO header is soldered on. 
Unfortunately, there don’t seem 
to be any Pi Zero cases that cover 
up this part of the board, and while 
there are definitely arguments for 
having it open, the option to have it 
closed off if needed would be nice. 
Like the wooden case, the 
acrylic one has the same etchings, 
precision cuts, and smoothness. 
Both are supplied with very sturdy 
screws that interlock over each 
other, rather than a nut and 
bolt. These same holes grab the 
Pi Zero as well, so they could be 


used for mounting purposes with 
the right equipment. 

Both versions of the case are 
ereat and sturdy. The heatsink 
seems a little like overkill, but 
it’s a nice little touch and it 
looks good aesthetically with the 
wooden case. If you really like 
the Zebra Zero case, there’s also 
a much larger one available that 
incorporates a breadboard, 
perfect for prototyping. 


fast word 


A great case with a fairly 
unusual look. It allows for full 
access to the ports on the Pi 


Zero — although if you're not 
using the GPIO, it makes it 
seem a Little exposed. 
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Maker 
Says 
A super 
affordable 
high-quality 
DAC for the 
Raspberry Pi 


Pimoroni 
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PIMORONI PHAT DAC 


HIFIBERRY 
DAC+ 
STANDARD 
RCA 


The HiFiBerry 
uses top-quality 
components 
and has RCA 
jacks pre- 
soldered, but 

its size makes it 
less suitable for 
Pi Zero use. 


£23 /$40 
hifiberry.com 
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the pHAT DAC may be just the add-on you need 


he Pi Zero’s minuscule 
dimensions make it well- 
suited to a variety of tasks, 
except for one omission from 

its feature list: analogue audio. 
For anyone trying to embed a Pi 
Zero into an old radio or speaker 
system, that’s a loss too far. 
Fortunately, the clever people at 
Pimoroni have a solution in the 
form of the pHAT DAC. 

Part of the pHAT family - a 
range of Hardware Attached on Top 
(HAT) boards built with the Pi Zero 
form factor in mind - the pHAT 
DAC adds a high-quality digital- 
to-analogue converter (DAC) to 
the board, allowing any Pi Zero to 
output line-level audio, ready for 
external amplification. 

The output of the pHAT DAC 
shouldn’t be confused with that 
of the analogue output of the full- 
size Raspberry Pi family, either: 
the pHAT’s Texas Instruments 
PCM5102A DAC is a cut above, 
offering noise-free 192kHz 24-bit 
line-level audio. 


The pHAT DAC is supplied 
with a 40-pin female header which 
needs to be soldered onto the board 
before it can be connected to the Pi 
Zero, to which you’ need to have 
soldered a 40-pin male header. 
There’s method in Pimoroni’s 
madness here: if you’re building a 
permanent project, you can drop 
the female header and solder the 
pHAT DAC directly to the Pi Zero’s 
pins to create an ultra-thin circuit 
board sandwich. You can also add 
a pair of RCA connectors, available 
separately for £1.50, to complement 
the 3.5mm jack. 

With the soldering out of the way, 
installation isn’t as straightforward 
as it could be. Step-by-step 
instructions are provided, but are 
unsuitable for the latest Raspbian 
release — and while a community 
member has stepped up and 
provided an installation script to 
make things easier, this isn’t yet 
linked from the product page. 

There’s another fly in the 
ointment once installation is 


If you’re disappointed by the Pi Zero’s lack of analogue audio output, 


complete: there’s no easy way 
to switch between the pHAT 
DAC and HDMI outputs. For 
most uses this isn’t a problem, 
but if you were planning to turn 
a Zero into a multi-function 
portable music player, it may 
cause a headache. 

When you’re up and running, 
there’s plenty to like about the 
pHAT, though — in particular, the 
superb audio quality when paired 
with a good-quality amplifier and 
decent set of speakers. 


fast word 


While the installation 
experience needs work, the 
pHAT DAC certainly fills a hole. 
If you need analogue audio 


from your Pi Zero, it can't be 
beaten — but paying three 
times the cost of the Zero itself 
may Sting a little. 
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Waker 
says 


Turn your 
Raspberry Pi 
Into d robot 


controller! 
MonkMakes 


ULTRABORG 


A different 

yet still very 
competent 
way to add 
motorboard 
and robot 
control to the 
Raspberry Pi. 
You can get it in 
many different 
kit versions. 


£16 / £23 
magpi.cc/1RJjeWC 


RASPIROBOT V3 BOARD 
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RASPIROBOT 
V3 BOARD 


Get a head start in making a Raspberry Pi robot with this board: 
it handles all the basics you need 


f you’ve ever made a 
Raspberry Pi robot, you’ ll 
know there are some basic 
essentials to bear in mind: running 
the motors of your automaton 

via the Raspberry Pi, and the 
ability to power the Pi and motors 
independently without using a 
trailing power cord. Then there are 
other, less-necessary bits such as 
wiring the robot up properly, and 
the ability to add sensors. These 
are Still important and something 
you’d have to learn, but there are 
different layers to cover. 

There are some products that try 
to encompass it all, and RasPiRobot 
is one of these. It’s a HAT (a 
board that attaches on top of the 
Raspberry Pi) offering access to 
two motor controllers, and will also 
power the Pi from a battery pack 
attached to it. This covers several 
of the issues faced when creating a 
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robot; add [?C and ultrasonic sensor 
connectors on top of this, as well 
as full access to the GPIO pins the 
board covers, and you have quite 
the complete package. 

The board is nice and compact, 
fitting neatly on top of the 
standard Raspberry Pi B+/2/3 
form-factor, and is even smaller 
than the A+. The board only 
requires the first 26 GPIO pins, 
making it functional on the original 
Model A and B too, in case you have 
one lying around waiting to be used 
for something. Everything comes 
pre-soldered and, honestly, for 
the price it’s a bit of a steal. Even 
if it may be slightly more targeted 
towards novices, it leaves plenty 
of room to grow. 

The board comes with its own 
Python library, with plenty of 
examples to figure out how it 
works. It’s fairly simple, requiring 


you to make sure the motors and 
main sensors are plugged into 
their intended slots, and you can 
definitely program any robot you 
create with it very efficiently. 
RasPiRobot V3 does what it sets 
out to do well, at a very good price. 
If you’re looking to start out in 
Pi robotics or want to take a step 
beyond beginners’ kits, you could 
do a lot worse than this board. 


fast word 


An easy-to-use kit that offers 
a lot of functionality for 
Raspberry Pi robot makers, 
with very little fuss or hassle. 


It's also very cheap for what 
you get, making custom 
robots a more attractive and 
affordable prospect. 
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Maker 
says 
Adds an 

enormous 

amount of 
variety and 
additional 
fun to every 
maker's 


toolbox 
ModMyPi 


KEYES 34-PIECE SENSOR 
EAPERIMENT KIT 


A box of tricks to play and learn with, but does it make sense to buy them like this? 


CAMJAM 
EDUKIT 2 


Far fewer 
sensors, but it 
does include 
everything you 
need — including 
breadboard 

and jumpers 

- to follow 

the excellent 
worksheets. 


£7 / $10 
camjam.me 
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or those making their 
first foray into the world 
of electronics, there’s a 
bewildering array of components 
to choose from. So a kit like this 
one can be a useful starting point. 
While it’s listed in the Arduino 
section of the ModMyPi site, and 
although it is labelled ‘for Arduino’ 
on the box, it will work with most 
microcontrollers, including the 
Raspberry Pi. The kit isn’t supplied 
with a breadboard or any other 
components, so you’ ll need to 
source those separately. 

You get a fairly wide range of 
sensors for your money, working 
out at £1 each. By our rough 
calculations, the combined cost 
of the components would come to 
at least £40 (plus any shipping), 
so it represents reasonable value. 
In addition, each part comes in its 
own ziplock bag, safely stowed in 
one of the compartments in the 


sturdy case. The only documentation 
supplied is a single sheet identifying 
each sensor, in English and Chinese, 
and some have misleading names. 
Fortunately, the ModMyPi site offers 
several handy links to find out more 
about the sensors and how to use 
them, including Python and C code 
examples, along with a Raspberry 
Pi-based lesson plan. 

One thing to note is that while 
this is described as a ‘sensor’ kit, its 
contents also feature a selection of 
switches, microphones, and LEDs. 
These are of varying usefulness. 
There’s some overlapping of 
functionality, too, with three 
different temperature sensors and 
three Hall effect modules to detect 
magnetic fields; since they require 
different implementation methods, 
though, it’s still beneficial for 
learning purposes. 

There are quite a few fairly 
standard parts, such as a couple 


of two-colour LEDs and buzzers. 
More exotic components include 

a flame sensor, which can detect a 
fire within 80cm, and a heartbeat 
sensor that’s placed around your 
finger and flashes an LED with your 
pulse. Other parts, such as an IR line 
follower and an obstacle avoidance 
sensor, may also come in useful for 
robotics projects. 


fast word 


The kit offers reasonable 

value, particularly with the 
compartment case included, 
and offers plenty of possibilities 
for experiments — so long as 


you already have some jumper 
wires, at least. Anyone focusing 
on a single project would be 
better off buying the required 
components separately. 
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Review 


RASPBERRY PI 
BESTSELLERS 


Wiley’s popular For Kids & For Dummies 
imprint turns out some near-genius works. 


RASPBERRYPI  —— 
PROJECTS FOR fj 
DUMMIES 


Author: Mike Cook, Jonathan 
Evans & Brock Craft 

Publisher: Wiley 

Price: £17.99 

ISBN: 978-1118766699 

magpi.cc/1TiAVfG 


Gets you started with Pi and 
workshop setup, then throws you 
into a fun world of cool projects 
- raspberry jazz glitter trio! - and 
teaches you electronics and 
Python along the way. 


RASPBERRY PI 
FOR KIDS FOR pf 
DUMMIES paspber"y 


Authors: Richard Wentk 
Publisher: Wiley 

Price: £21.99 

ISBN: 978-1119049517 
magpi.cc/1TiBaXZ 


ts 
ath 
Fun Prop 


From Scratch and Sonic Pi, via 
command line and nano, to 
Python and choosing a web 
server, Wentk's clear style and 
gentle humour make each 
learning challenge approachable. 


PYTHON _ 
FOR KIDS a 
FOR DUMMIES 


Authors: Brendan Scott 
Publisher: Wiley 

Price: £21.99 

ISBN: 978-1119093107 
magpi.cc/1TiBiHd 


A great range of projects 
(both silly and useful) to 

take readers of any age 

from the basics, through to 
object-oriented programming 
techniques. We can even 
forgive the use of Python 2.7! 
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THE MAKER'S GUIDE apocalyptic world is a lack of 


TO THE ZOMBIE 
APOCALYPSE 


Author: Simon Monk 
Publisher: No Starch 
Price: £16.50 

ISBN: 978-1593276676 
magpi.cc/1VgmTtW 


Have you ever 
pondered how 
you would 
Survive a zombie 
apocalypse? No? There’s no need to 
panic: Simon Monk has given the 
matter extensive consideration, 
and the result of all his hard work 
is an entertaining, yet surprisingly 
useful collection of projects for 
the Raspberry Pi and Arduino. 
Monk says people tend to be 
either zombie lovers or zombie 
indifferent: your reviewer falls into 
the latter category, yet was won 
over by the sheer geeky genius of 
the whole enterprise. 

The first problem faced by 
electronic hobbyists in the post- 


INTERMEDIATE C 
PROGRAMMING 


Author: Yung-Hsiang Lu 
Publisher: CRC 

Price: £49.99 

ISBN: 978-1498711630 
magpi.cc/1VgnbkK 


After completing your 


first C tutorial, youthen [aim 


run up against a yawning 
gap to cross. There are many 
specialist books for advanced C 
programmers, and plenty of code 
out there to read, but to make the 
leap from writing short programs 
of perhaps 20 lines of C, toa 
couple of thousand lines of code, 
you need Lu’s help to learn some 
essential concepts. 

There is enough information 
here to pull confident beginners 
through (supplemented, perhaps, 
with a basic online tutorial). This 
isn’t structured like a typical 
beginner’s tutorial, however, and 


: Intermediate C Pro gramming 


| Tung-Hsiang Ly 


electricity: solar cells are covered, 
but the bike- powered generator 
has real DIY kudos, and could be 
powering your maker shed well 
before the apocalypse arrives. 
Alarms, distractions, Morse code, 
and haptic communication are 
among what follows. 
The Pi is used in video 
monitoring of zombies via 
USB webcam, setting up an FM 
transmitter beacon to communicate 
with other survivors, and a control 
centre in which it integrates with 
some of the Arduino projects. 
Beyond this are a range of simple 
and fun electronics circuits, and 
every chapter is packed with useful 
information on electronic theory, 
construction, and programming 
nuggets, along with tips for 
surviving the zombie apocalypse. It 
might not happen, but it would be 
foolish not to be prepared. 


Score 


it (usefully) gives a lot of useful 
coverage to low-level interactions 
between your code 
and the hardware: 
early treatment of the 
stack, for example, 
is recalled a couple of 
chapters later, when 
looking at pointers and 
call-by-value. 
Combining maths 
and programming, Lu 
also uses the full GNU/ 
Linux suite of C tools. Testing and 
debugging are both emphasised 
— including use of Valgrind to 
check for memory errors — and 
both from a lot earlier on than 
is customary in other works, for 
which full marks to Lu. But the 
author emphasises that “no tool 
can replace a clear mind”, and 
endeavours to give you the skills 
and mindset to code correctly in C. 


Score 
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NUMERICAL 
PY THON 


Author: Robert Johansson 
Publisher: Apress 

Price: £35.50 

ISBN: 978-1484205549 
magpi.cc/1PWNUTe 


Python’s numerical 
and mathematical 
modules aren’t just appreciated 
by coders working in the sciences: 
the PSL, NumPy, matplotlib, et 
al. are also very useful in business 
management, financial engineering, 
big data, and even cloud computing. 
It is for these fields that Johansson 
has written this detailed guide. 
After a good introduction on 
[Python with its notebook feature, 
Spyder is suggested as an IDE 
apt for numerical Python work. 
Some essentials for numerical 
computing (vectors, matrices, and 
multidimensional arrays) follow, 
to ease the reader into NumPy; 


LEARNING 
ELIXIR 


Author: Kenny Ballou 
Publisher: Packt 
Price: £22.99 

ISBN: 978-1785881749 
magpi.cc/1PW/Pbd4 


If you’re looking 
to try functional 
programming to build more resilient 
apps, then Elixir with its Ruby- 
inspired syntax is a good choice. 
Ballou eases the reader in with 
Elixir types, such as atoms, and 
other features like lazy evaluation 
of ranges. Very gently, a lot of what 
seems Strange in a quick glance at 
Elixir and Erlang, is made familiar, 
or at least intriguing. Pattern 
matching and the map function 
round off chapter 2, preparing you 
to work with modules and functions. 
Ballou skilfully builds on ideas 
presented earlier, combining 
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then SimPy to use analytical and 
symbolic methods on problems. 
Visualisation with matplotlib 
furthers these foundations. 
Building on these 
fundamentals, the following 
chapters survey the domains 
of applied mathematics 
and computational science, 
solving problems, and using 
some of the best of Python’s 
diverse packages. Working 
through everything from 
linear equation solving, through 
Sparse matrices, to Bayesian 
Statistics, Johansson helps you 
brush up on problem solving, 
mathematics, algorithms, data, and 
even Serialisation. 

[Python notebooks containing the 
source code listings for each chapter 
can be downloaded from Apress 
or Johansson’s GitHub pages. The 
book is a valuable reference across 
many fields. 


Score 


pattern matching, first class 
functions, and features of the Erlang 
VM to build your understanding 
of Elixir, before introducing more 
advanced features and 
setting started on functional 
algorithms. Tail recursion and 
sorting algorithms highlight 
the efficiency of Elixir. 

More data structures and 
pattern matching lead onto 
flow-based programming, 
or stream processing. All this 
without control statements, as 
branching is introduced late — 
functional algorithms make it 
less necessary — ina short chapter 
which also (finally) brings in 
testing. Ballou rounds off with other 
necessities for full use of Elixir: 
concurrency, the OTP framework, 
and metaprogramming. Learning 
Elixir is concise, useful, interesting 
— like the language itself. 


Score 


ESSENTIAL READING: 
CLOJURE ESSENTIALS 


Learn the greatness of immutable data, 
concurrency, pure functions, and metaprogramming 
with these essential recent releases. 


Clojure for the 
Brave and True 


Author: Daniel Higginbotham 
Publisher: No Starch 

Price: £23.50 

ISBN: 978-1593275914 
nostarch.com/clojure 


Not an in-depth study, but a practical 
and fun way of getting started with 
Clojure and functional programming. 


Clojure Applied 


Author: Ben Vandgrift & Alex Miller 
Publisher: Pragmatic Bookshelf 
Price: £25.50 

ISBN: 978-1680500745 
magpi.cc/1PWPy7p 


Move from the basics, to using ~S 
immutable data structures and first class © 
functions in real code for real work. 


Clojure in Action 


Author: Amit Rathore & Francis Avila 
Publisher: Manning 

Price: £35.31 

ISBN: 978-1617291524 
magpi.cc/1PWPCUI 


Expanded and updated for Clojure 1.6, 
with ClojureScript, and fewer Java-based ue 
assumptions - ideal for Pythonistas and Rubyists. 


Clojure for 
Data Science 


Author: Henry Garner ae es 
Publisher: Packt Hf{\ x 
Price: £28.99 oS 1 A 
ISBN: 978-1784397180 Clojure for Data Science 
magpi.cc/1PWR4qb 


Garner will improve your practical Clojure 
skills whilst giving you a thorough and 
comprehensive grounding in handling data. 


Clojure Recipes 


Author: Julian Gamble 
Publisher: Addison Wesley 
Price: £24.99 

ISBN: 978-0321927736 
clojurerecipes.net 


Build on your Clojure knowledge to 
gain real-world skills with DSLs, Storm, 
Datomic, and ClojureScript. 
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Community 


THE MONTH IN 
RASPBERRY PI 


Everything else that happened this month in the world of Raspberry Pi 


PERFORM YOUR OWN 


EXPERIMENTS 
WITH SENSE HAT 


ith the Astro Pis now switched on, schoolkids’ 
code is being used in low-Earth orbit to test out 
new and amazing things. Powering the Astro 

Pi is nothing more than a Sense HAT and a camera 
module attached to a Raspberry Pi: parts that are easily 
obtainable. You can also perform your own experiments 
with them, and we have a few you can check out in 

our book, Experiment with the Sense HAT, available as 

an e-book and now also in print. Here are some of the 
amazing tutorials you can find in it. For more details on 
where to get it, visit: magpi.cc/Sense-HAT-book. 


DIGITAL MAGIC 8-BALL 


Use the Sense HAT’s motion sensors to create a fully 
functional magic 8-ball and experiment with the 
accuracy of a random number generator as it tries 

to predict the future. This project teaches you about 
the various motion sensors and gyros on the Sense 
HAT, as well as giving you some tips on how to use 
the LED matrix to display text and messages. It’s all 
programmed in Python 3, so it also teaches you more 
about how to use the popular language. Maybe you 
could modify the code and create your own version? 
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SENSE HAT DATA LOGGER 


If you want to make the most of all the various sensors 
and gizmos on the Sense HAT, the data logger allows 
you create a record of all the HAT’s different readings: 
temperature, pressure, humidity, motion, tilt, etc. It’s 
programmed in Python and also gives you some tips on 
how to read the data properly. From here you can create 
eraphs and charts to display the changing conditions of 
your bedroom, kitchen, or garage. You could use the data 
to figure out when it’s coldest, when people may have 
entered, or anything else you can think of. 


ASTRONAUT 
REACTION GAME 


This game is very similar to one Tim Peake and the rest 
of the crew of the International Space Station are using 
on the Astro Pi. This one is coded in Scratch, though, 

to make it more gamey, and it allows you to test your 
reaction times. There are even some special graphics 
you can use in it where Tim Peake himself will show up! 
This one is less an experiment on your surroundings 
and more of an experiment on yourself and friends: can 
you train yourself to get faster? 
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CROWDFUND 
THIS! 


The best crowdfunding hits this 
month for you to check out... 


P1433 - RADIO MODULE 


While the new Raspberry Pi 3 now has a built-in 
wireless internet connection, that’s not quite the same 
as aradio transmitter and receiver. This crowdfunding 
project is for a 433MHz radio module, hence the name, 
and allows for communication to the Pi over that 
frequency, between two Pis on it, and with anything 
else that operates over 433MHz as well. It should be 
nearing completion by the time this issue comes out, 
so give it a look if you’re interested in another wireless 
way to use your Raspberry Pi. 


PIJACK - ETHERNET | 
FOR PI ZERO 
= ll — 


Much like the Model A and A+, the Raspberry Pi Zero 
lacks an Ethernet port. The Zero forgoes it for the sake 
of keeping its size down, and you can add an Ethernet 
connection via USB if you wish to do so. There is a new 
solution trying to get crowdfunding, though: the PiJack 
is a HAT for the Pi Zero which adds a10Mbps Ethernet 
port. It’s only 10Mbps to keep costs down, making it 
suitable for something like the Pi Zero. It will then easily 
integrate into Raspbian as well. 


raspberrypi.org/magpi 


THIS MONTH IN PI 
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ANALOG EXPANDER CAP 


Much like the reason the Raspberry Pi Zero doesn’t have 
an Ethernet port, there are no analog audio- and video- 
out ports in order to save space. Ben has created a HAT 
for the Raspberry Pi Zero that fits over the GPIO pins and 
adds VGA, composite video, and audio-out ports. The 
PCB it sits on neatly fits the dimensions of the Pi Zero, 
just about squeezing the three ports on top of it. It has 
already been funded, so you should hopefully be able to 
get your hands on one even if you miss the campaign. 


BEST OF THE REST 


SMOKEY PI 


mage: cc/1R6WFZW | 
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INTERVIEW 


Community 


HOUNDIFE Y 


ADD VOICE CONTROL 
TO YOUR PROJECTS 


SoundHound’s speech-to-meaning engine enables better voice control and 
customisation. Its creators think it could revolutionise your Pi projects... 


e started working on this 
project more than nine 
years ago; we had this 
vision that one day you’re going to 
talk to all the technology around 
you,” Keyvan Mohgjer, CEO of 
SoundHound, tells us. SoundHound 
is a popular audio recognition 
software for smartphones that 
you’ve probably used at some point 
to identify a song you can hum but 
don’t know the name of. Today, 
though, we’re talking to Keyvan 
about the recent announcement 
and release of Houndify. 


Houndify is the next generation 
in voice-recognition software, 
beyond the likes of Google Now 
and Siri that are currently available 
on mobile devices. 

“Technology like computers, 
cellphones, cars, fridges, your 
thermostat, etc. — we will be 
talking to them, they will be 
talking back to us, and we’1l 
continue talking together,” 
explains Keyvan. “A conversational 
interface between humans and 
technology. We had this vision 
more than a decade ago and today 


Keyvan Mohajer 
is the CEO of 
SoundHound 

- the company 
behind Hound 
and Houndify - 
which he founded 
in 2005 
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that seems obvious because it’s 
happened, but I assure you that 
when we were sharing our vision 
with other people in the early days, 
a lot of people had doubts.” 


Three laws safe 

How does Houndify work, then, 
and what differentiates it from 
other software? According to 
Keyvan, there are three main parts 
that make it different: 

“The first one is what we 
call speech-to-meaning. What 
SVE VOM AIS Gees 18 SHeeChi= = 
text and then text-to-meaning... 
We saw two problems with that; 
one is latency or speed, so if you 
Maite TOGO SOS SO Tees ier, 
text-to-meaning, the user has to 
wait for that. Maybe some short 
queries are OK, but queries that 
get a little more complex and 
longer oftentimes you see a delay, 
even with Google. 

“The other problem that’s less 
obvious is accuracy. If you do 
speech-to-text blindly without 
caring about the meaning, you’re 
more likely to make a mistake, and 
then you’re sending that wrong 
text to the next step. If you think 
about how your own brain works 
as you listen to people talk, you’re 
not doing speech-to-text in your 
brain — you’re doing speech-to- 
meaning, and caring about the 
meaning helps you with accuracy 
of your analysis in your own 
brain. We thought that if we can 
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(©) HOUNDIFY 


Domains 


The various domains that can be 
used with Houndify, from hotel 
and weather to more abstract 
domains like blackjack 


How do credits work? 


Browse Public Domains Browse Private Domains 


understand the meaning in real- 
time as we are understanding the 
text, we can do a better job with the 
accuracy also. That turned out to be 
true: with our benchmarks, we saw 
a huge improvement in accuracy.” 
The second key difference 
is the ability for Houndify to 
understand complex queries, 
amd tis 1s the aspect that really 
impresses people. Users go from 
asking a serious of short questions 
to asking long strings which 
would not be usable anywhere 
else. For example, the following 
sentence works with Houndify: 
‘Show me hotels in San 
Francisco for tomorrow that are 
less than $300 but not less than 
$200, are pet friendly, have a 
eym and a pool, with three or 
four stars, staying for two nights, 
and don’t include anything that 
doesn’t have air conditioning.’ 


Master of your domain 
Last but not least, Houndify’s 
‘domains’ are a key differentiator. 
“It’s important to understand 
that this is not like magic,” 
Keyvan explains. “You can’t just 
make it all work with everything. 
If you want it to understand 
weather, you have to integrate 
it with the weather provider 
and understand the type of 
interactions that people will do 
with that domain. Same for if you 
want to understand stock markets 
or local business search or hotel 
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search. These are all domains. We 
call them domains because they 
are big but they’re very specific, 
so they need to be added one by 
one. We thought that to make this 
really useful, we need to be able 
to understand a lot of things, so 
we need to be able to add these 
domains very fast.” 

Google and Apple also use such 
domains, but they only have a few 
and have not added many new 
ones in the past few years. 

“We built a platform that 
allows us to add these domains 
faster and more efficiently than 
[rival services],” Keyvan tells us. 
“The key was that you don’t have 
WO Se 2 SCTE Su in unsit Sjeece 
to be able to use the platform. 
You don’t need to have a PhD 
in linguistics or speech; we 
employ fresh computer science 
eraduates, and they are able to 
understand our platform and add 
new domains within days. When 
we announced our platform in 
June of last year, we had about 
50 domains; today we have more 
than 110 domains... Eventually 
we will open the domain level 
part of this platform to outside 
developers, and that’s when we go 
from hundreds internally to 1,000 
LO10 C002, 100,000. youl know. 
1,000,000 domains.” 

Houndify is available for use 
in projects now for free and on 
Raspberry Pi. Check houndify.com 
for more information. 


HOUNDIFY 
WITH PI 


HOUNDIFY 


Community 


Above The 
office espresso 
machine was 
‘Houndified’, 
and can 

now holda 
conversation 
as it brews 


Houndify works well on the your coffee 


Raspberry Pi, with enough 
resources to run it just fine. 
Keyvan tells us how it has 
been used: 

“We sponsored a huge 
hackathon at the University 
of Pennsylvania and they had 
1,300 students working over 
two or three days. We had a big 
presence there and | believe 
Houndify was the most used API 
in the whole hackathon. There's 
a lot of interest by the developer 
community and a lot of them use 
the Raspberry Pi.” 

In the Houndify office itself, 
an engineer hacked their 
espresso machine to talk to 
users — after it takes your order 
first, of course. 


HOUND: OUT NOW 


Hound, the first-party app that uses Houndify on 
iOS and Android, has been in private beta since it 
was announced last year. By the time you read this 


magazine, the full version will be out for everyone 
to use. It makes use of all the excellent features 

if Houndify for a better voice-control experience 
on your device. It's not on the Raspberry Pi, but it's 
definitely worth a look! 
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RASPBERRY 
JAM 


Want to add your get-together? List it here: 


raspberrypl.org/jam/add 


RASPBERRY Pl 

BIG BIRTHDAY WEEKEND 

When: Weekend 5-6 March 

Where: University of Cambridge 
Computer Laboratory, 
Cambridge, UK 

magpi.cc/1Sx4meX 

Celebrate the Pi’s fourth birthday 

at this weekend-long jam. 


PRESTON RASPBERRY JAM 

When: Monday 7 March 

Where: Media Innovation Studio, 
Prestom Wik 

magpi.cc/1Pgysj4 

Learn what you can do witha 

Raspberry Pi computer in an 

open, sharing, family-friendly 

environment. 
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SWAB PI INTEREST GROUP 
When: Wednesday 9 March 
Where: Roebuck Pub, 

Winchester, UK 
magpi.cc/1PgyqaY 
Southampton, Winchester, 
Andover, and Basingstoke 
Raspberry Pi enthusiasts have a 
drink and play with Pis. 


CORNWALL TECH JAM 
When: Saturday 12 March 
Where: Bodmin College, 
Bodmin, UK 
magpi.cc/1okaryY 
An event for anyone who’s 
interested in computing and 
technology — all ages are 
welcome to attend. 


RASPBERRY Pl 
DC MEETUP 


RASPBERRY JAM 
BOGOTA 2016 


YORKSHIRE MARS MISSION 
When: Saturday 12 March 
Where: Swallow Hill 
Community Gollece, 
Leeds, UK 
magpi.cc/10kaqeg 
Explore the opportunities of the 
Raspberry Pi and help launch a 
Mars mission... sort of. 


HANDS-ON RASPBERRY PI 

COMPUTING 

When: Wednesday 16 March 

Where: Wyche Innovation Centre, 
Malvern, UK 

magpi.cc/1okauL6 

A series of informal hands-on 

Pi workshops to encourage those 

who don’t have access to one. 
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HANDS-ON RASPBERRY PI 
COMPUTING 


RASPBERRY JAM 

BOGOTA 2016 

When: Friday 18 March 

Where: Universidad Pedagogica 
Nacional, Bogota, Colombia 

magpi.cc/1okavyl 

This year, the plan is to promote the 

use of the Raspberry Pi and build the 

Colombian Pi community. 


RASPBERRY PI DC MEETUP 

When: Saturday 19 March 

Where: Difference Engine, 
Washington DC, USA 

magpi.cc/1okaAm1 

Learn how to always keep 

track of your Raspberry Pi 2 

on the internet, with a talk 

about xProDDNS. 
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DON'T MISS: 


When: Weekend 5-6 March Where: University of Cambridge Computer Laboratory 


The Raspberry Pi is now four years 
old! Celebrate its birthday and find 
out what all the fuss is about at the 
same fantastic venue for last year’s 
event. There'll be lots of vendors and 
demo tables, including the team from 
The MagPi. There's also a party on the 
Saturday evening, separate from the 
rest of the weekend's activities. For 


more details, check out the event page: 


magpi.cc/1Sx4mexX 


PRESTON 
RASPBERRY JAM 


G YORKSHIRE MARS MISSION 
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RASPBERRY PI 
BIG BIRTHDAY WEEKEND 


3) SWAB PI INTEREST GROUP 
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blueberry ww JVM 


Turn your Raspberry Pt 
into a Multi-Purpose 
lol Controller Boara 


The Blueberry lol Controller for the 
Raspberry Pi is a versatile device designed 
to interact with the real world by reading 
sensors, controlling electrical equipment 


CONTROL 


gates, garage doors, air-conditioning, 
irrigation systems and much more. 


and using popular communication channels. 


lt is supported by a range of other devices 
which can turn your Raspberry Pi into 
the nerve centre of a simple or complex 


ae Use the power and connectivity of the Pi or the on-board 
monitoring and control system. 


GSM to control your system from anywhere in the world 
or receive reports and alerts via email or texts (SMS). 


=Rapid www.rapidonline.com 


electronics Rapid Electronics part of the (ONRAD Group 


Pi-DigiAMP+ 


* Raspberry Pi HAT, no soldering required =» Pi-DAC+ accessory, no soldering required * Raspberry Pi HAT, no soldering required 


* Full-HD Audio (up to 24bit/192MHz) * Full-HD Audio (up to 24bit/192MHz) * Full-HD Audio (up to 24bit/192MHz) 

+ Texas Instruments PCM5122 - Texas Instruments TPA3118 * Texas Instruments TASS/7S6M 

- Variable output to 2.1v RMS * Up to 2x35w of stereo amplification * Up to 2x35w of stereo amplification 

* Headphone Amplifier / 3.5mm socket * Provides power to the Raspberry Pi * Out-of-the-box Raspbian support 

* Out-of-the-box Raspbian support * Software mute on GPIO22 * Integrated hardware volume control 

+ Integrated hardware volume control * Auto-Mute when using Pi-DAC+ headphones _* Provides power to the Raspberry Pi 

* Access to Raspberry Pi GPIO * Input voltage 12-19v * Software mute on GPIO22 

* Connect to your own Hi-Fi's line-in/aux * Supports speakers from 4-80hm * 1/0 (i2c, 3v, Sv, Ov, GPIO22/23/24/25) 
* Industry standard Phono (RCA) sockets * Just add speakers for a complete Hi-Fi 


* Supports the Pi-AMP+ * Input voltage 12-19v 
¢ Supports speakers from 4-80hm 


IQaudio Limited, 


Twitter: @IQ_audio Swindon, Wiltshire. 
Email: info@iqaudio.com WWW.IQAUDIO.COM Company No.: 9461908 


+) Components 


TAKE A 
OUP w OmnT LOOK 


_ bcshop D.co 


?LATEST 


ALL YOUR RASPBERRY PI CASE NEEDS COVERED! 
PI ZERO CASES AVAILABLE! 


EVERY PI NEED! 
Latest Pi Model B 
New Pi Zero 
Spi-Box 
MEDIAPI 
PiFace 


LCD Control cases 


oO [a] www.sb-components.co.uk Call: 0203 514 0914 


At SB Components we strive to offer our customers the best prices tor the best products. 
obey a, Our product team works tirelessly to source top quality attordable components trom around the world. 


m m_ Raspberry Pi is a trademark of the Raspberry Pi Foundation. Raspberry Pi not included. *Compatible with Raspberry Pi 


The Raspberry Pi 
3 is here and has 
wireless as a Lot 
of people wanted 


LETTERS 


Missing print issues 
Hi, I do like that you can download all the issues 
of The MagPi, and I do keep a collection of the 
PDFs on my computer to refer to when needed, 
but I have a hard-copy collection as well. 
I noticed you’ve never printed issues 31 to 35 of 
the magazine and I was wondering if I’d missed 
them being printed or if you had plans to print 
them in the future? 

I’d really enjoy completing my collection with 
these issues! Thanks, 
Howard E 


Hi Howard. You haven’t missed any print runs 

of issues 31 to 35: they were released before The MagPi 
became distributed in newsagents and other 

shops, starting with issue 36. What we have done, 
though, is collect all the great content from those 
issues and put them into the Official Raspberry Pi 
Projects Book. 

It has 200 pages full of projects, tutorials, reviews, 
and features — the very same found in the original 
issues 31 through 35 with a couple of extras to make 
it truly great. It’s still on sale as well, and will set you 
back only £12.99. You can get it from the Swag Shop 
(magpi.cc/1ollas3) or alternatively from Amazon 
(magpi.cc/Projects-1). 
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Printed essentials 
Hi MagP1, I really like your Command Line Essentials 
e-book. I know it’s part of a bigger series, but is 
there any chance of getting a print version of this 
or the others? The Command Line would help me with 
some of my studies and I think the rest would be 
really useful in the future to me! 

Thanks, 
Mohammed Ikram 


You’re in luck, Mohammed: we’ ve just started to 
print out the Essentials books right now! This includes 
the first book, Command Line Essentials, along with our 
Python gaming and Sense HAT experiments books. 
They each cost £3.99 in print, although if you want 

to get them as e-books via our Android or iOS app, 
they'll cost you £2.99 there. 

There’ll be more to come in the future as well, 
which we’ll try to print-release as well as the normal 
digital release. These print releases have all the same 
ereat content as the original e-books, but now with 
the fantastic print quality of The MagPi and The Official 
Raspberry Pi Projects Book. 
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O O 
FROM THE FORUM: 


The Raspberry Pi Forum is a hotbed 
of conversation and problem- 
solving for the community - join 
in via raspberrypi.org/forums 


ome of the code examples in the magazine 

don’t always work for copying and pasting, 

as they contain typographical quotation 
marks, which do not work in Python. Also, around 
dashes often there are invisible spaces, spoiling the 
interpretation of the code by the Python system. 
Would be good to leave code examples verbatim 
as-is, with no reformatting whatsoever, or have all 
of them available online via GitHub where they can 
be downloaded. 


rm53 


Some of the errors when copying and pasting can 
sometimes just be down to your PDF reader, so 

if you’re doing it that way, then you may need to 
double-check the way the code is when it’s in the 
editor you’re using. 

Otherwise, most of the code is available on 
GitHub and we’re going to start implementing our 
own GitHub page where any remaining code can 
be downloaded — it may even be up Starting with 
this issue! Where we can, we’! put the link to these 
GitHub repos into tutorials. 
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TAKE US 


DO SCIENCE rz" 
SAVE SENSE HAT 


eS 
| WITH OUR NEW 
h d 
: (! oes portion ESSENTIALS 
(limited time offer) 


OFFICIAL : 


A RASPBERRY Pl 3! WE'VE GOT 10 TO GIVE AWAY 


AVAILABLE ON 
THE MAGPI APP! 


HACK MINECRAFT §=§Ql'| > att 
wy ze stags ee in & ~ —_— 


ia pineal 
Beebeoct 


Pee PI ZERO 
splices ; pe i 42 PROJECTS 


: i : mm SENSE HAT? 
ASTROPHiSS MISSION UPOATE FREE TO SHARE Se . ! > TIAA : 
THE ULTIMATE Al ZERO CLUSTER seni mare miner 
DO SCIENCE WITH THE SENSE HAT ‘aevidaecutuaai a 
MAKE A PL-POWVERED WAKE-LIGHT as Geis ietictin cess [ ii iT 
THE ONLY MAGAZINE WRITTEN BY THE COMMUNITY, FOR THE COMMUNITY [ReaD ! 


AG;13237 DOWNLOAD ALL 30 ORIGINAL ISSUES 


| 1 
Download it today - it’s free! 


Get all 30 legacy issues free 
for smartphones & tablets 


Instant downloads every month 


We nnionne GETITON Fast rendering performance 
@& App Store >» Google Play 


Live links & interactivity 


© 
| £2.29 £26.99 


Magazine rolling subscription full year subscription 
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Raspberry Fi 3 Model B Vi.2 
(c) Raspberry Pi 
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Competition closes 28 March 2016. Prize is offered worldwide to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize supplier, 
their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from the 
competition in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 


spam. Participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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Column | THE FINAL WORD 


ntegrated WiFi has been at the top of 
Raspberry Pi feature wish-lists for a very 
long time. Even though our top-of-the-line 
model has always been equipped with an Ethernet 
jack and it’s easy to find cheap USB WiFi dongles, 
there’s no doubt that our community wants wireless, 
and they want it on-board. It’s why I know you will 
absolutely love Raspberry Pi 3 for its built-in WiFi 
and Bluetooth connectivity. 

Count me among all of you who wanted this for so 
long. Network connectivity is a must-have for the 
many ways I use a Raspberry Pi. I often work on my 
laptop and remotely log into the Pi to upload files 
or to control it. My projects also often use APIs for 
getting or posting data online or interacting with 
social media services. I know a lot of people who use 
Raspberry Pi around their homes and businesses for 
Internet of Things applications. For many of us, WiFi 
is a basic requirement for what we want to do. USB 
WiFi dongles have become a de rigueur accessory for 
Raspberry P1. 

And while WiFi is becoming increasingly 
ubiquitous, Ethernet connectivity remains hard to 
find in many places. If so many Raspberry Pi users 
are adding USB WiFi to their boards, it’s great to be 
able to give them wireless connectivity out-of-the- 
box without even raising the price of the board. 

I’m sure that Bluetooth will also be a very popular 
feature. It means that the Raspberry Pi will be able 
to talk directly to other devices, including speakers, 
computers, phones, watches, and other Raspberry 
Pis. In my office I have a Bluetooth-enabled portable 


And even though the big headline about Raspberry 
Pi 3 is the added wireless functionality, the faster 
processor on the board delivers a very nice bump 
in performance over the Raspberry Pi 2. And if you 
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photo printer that I’ve been eager to experiment with. 


MATT RICHARDSON 


Matt is Raspberry Pi's US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 
and a contributing editor at Make: magazine. 


Matt Richardson shares his excitement at Raspberry Pi 3’s new features 


compare it to the very first Raspberry Pi, we’re 
talking about major gains in speed. I’ve been lucky 
enough to spend some time with Pi 3 already. It 
boots up faster than ever and the desktop experience 
is now particularly snappy. It goes without saying 
that better performance means an all-around better 
experience for our education and hobbyist users. 


Connectivity for all 

Being able to deliver the absolute best product we 

can while keeping the price as low as possible isa 

part of our mission to make computing affordable. 
A major aspect of that mission is helping to make 

connectivity affordable as well. 

Take for instance the RACHEL-Pi project. It’s 
a Raspberry Pi-based WiFi hotspot which serves 
offline content to devices such as tablets, mobile 
phones, and computers. Content modules include 
offline versions of Wikipedia, TED Talks, medical 
references, and law libraries. Along similar lines 
to RACHEL-Pi is the Outernet project, which also 
serves cached content. In the case of Outernet, the 
content is delivered via a satellite receiver, can be 
stored on a Raspberry Pi, and is supplied to WiFi- 
enabled devices in places where connectivity is 
scarce. Bundling WiFi with Raspberry Pi 3 means it 
will be easier and more affordable for projects like 
these to deliver offline content to places without 
internet connectivity. 

Whether you’re a hobbyist, a network 
administrator, an educator, or you’re deploying an 
Outernet receiver in Uganda, I’m certain you’1l love 
Raspberry Pi 3’s built-in wireless connectivity and 
its performance gains. I see it as a win for everyone 
when we can scratch something off the feature 
wish-list without having to dig deeper into our 
pockets to pay for it. 
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“The FUZE is what NATIONAL 
- / the Raspberry Pi |iMajsay 
was designed for’ S==mrarsrm 


Protect your Pi from physical & static 
damage 


UK keyboard* & 4 Extra USB 
ports 


FUZE I/O Board with 40 
way GPIO pass-through 


Clearly labelled input 
Output ports 


2 Amp power supply and 
on/off switch! 


Adds analogue ports, 4 in & 1 out 


ae & & & & & & 


840 pin solderless breadboard (black) 


Reviewed model FUZE T2-R 


PC PRO Recommended ba mart 
... makes the Pi more EDITOR'S CHOICE 


BUY IT AWARD accessible than ever ... It's certainly the best 
we've ever tested 


Computer act!ve 


FUZE T2-C-SE 
* USA & German keyboard layouts are also BO IN U S 
available. Prices include VAT but not shipping - Includes 8GB SD pre- 


see fuze.co.uk for details 


configured with 
Technologies Ltd. Raspberry Pi and the Raspberry Logo FUZE BASIC 


are trademarks of the Raspberry Pi Foundation and are 
used with permission. All rights reserved. 


©2015 FUZE & the FUZE logo are trademarks of FUZE 


CODE MUSIC 
m= OONIC PI 


Get started today for LIVE CODE & CREATE AMAZING SOUNDS 


just £2.99/$3.99 von Raspberry Pi 


Ma 


9 Available on the 


« App Store 


® From the makers of the 
| official fF © olicial Raspberry Pi magazine P1 magazine 


GET IT ON 


>» Google Play Find it on 


The 4 


i] i] 
[ MAKE MUSIC WITH SONIC PI] q | G | i Q | Q D D 
| The ff ye : Below The Akai MPC 2000, a classic early sampler 
ESSENTIALS r — | 


CHAPTER 


CODED BEATS 


Sonic Pi creator Sam Aaron continues his essential new series 
with one of the most influential drum breaks in music history... 


ne “of the most exciting and revolutionary technical 

developments in modern music was the invention of 

computer-based samplers in the late 1970s. These 
electronic boxes of tricks allowed you to record any sound into 
them and then manipulate and play back those sounds in many 
interesting ways. For example, you could take an old record, find 
a drum solo (or break), record it into your sampler, and then play 
it back on repeat at half-speed to provide the foundation for 
your latest beats. This is how early hip-hop music was born, and 
today it’s almost impossible to find electronic music that doesn’t 
incorporate samples of some kind. Using samples is a really great 
way of easily introducing new and interesting elements into your 
live-coded performances. 

So where can you get a sampler? Well, you already have one: 


it’s your Raspberry Pi! The built-in live-coding app Sonic Pi has Ai 


LIVE CODE & CREATE AMAZING SOUNDS 


youR SY Pi 


by Sam Aaron 


an extremely powerful sampler built into its core. Let’s play with it! 
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magpi.cc/sonic-pi-book 
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